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1  iDtrodactioD 

Vsh  is  a  UNIX  shell  that  facilitates  access  to  the  VICOM  image  processing  system  from  a 
host  con^juter.  The  major  fimctions  of  vsh  are: 

Issiie  VICXDM  commands  from  the  users*  terminal  on  the  host  computer. 

Implement  VICXDM  command  files  (chain  files)  with  parameters. 

Facilitate  transfer  of  images  between  the  VICOM  and  the  host  system. 

Provide  access  to  the  normal  UNIX  shell  facilities. 

Provide  access  to  the  VICOM  from  users'  programs. 

Integrate  as  much  as  is  feasible  the  VICOM  with  other  available  image  processing 
software  and  systems. 

Vsh  is  the  first  stage  of  the  development  of  an  image  processing  environment.  The  goal  is  to 
develop  an  environment  that  is  powerful  and  convenient  for  the  user  to  use  and  facilitates  integra- 
tion of  new  image  processing  tools. 

The  implementation  described  here  is  for  a  FOS  (Firmware  Operating  Syston)  VICOM  and 
a  VAX  750  running  UNIX  4.2bsd.  The  major  task  in  porting  vsh  to  anothK  Systran  would  be 
developing  a  driver  for  the  image  transfer  device  in  the  uSJDC  syston. 

Vsh  provides  a  command  environment  in  which  commands  may  be  processed  and  executed 
by  the  VICOM  in  an  interactive,  one-command-at-a-time,  mode,  or  from  user  programs.  The 
need  for  a  special  VICOM  shell  arises  because  image  processing  research  frequently  requires  an 
extremely  high  level  language  which  can  be  easily  modified  and  debugged  interactively. 

Currently,  vsh  is  an  interpreted  language.  Symbol  substitution  and  control  features  have 
been  kept  extremely  single  in  the  interpretive  version  of  vsh  for  efficiency  reasons.  When  greater 
control  structure  functionality  is  needed,  vsh  should  be  invoked  from  within  a  user  program.  The 
languages  that  support  invocation  of  vsh  are  C,  FORTRAN  77,  and  Pascal.  A  compiled  version  of 
vsh  is  being  considered.  If  developed,  the  compiled  version  can  be  expected  to  support  greatly 
enhanced  features. 

This  document  is  intended  for  NYU  users  of  vsh,  and  is  periodically  revised  to  account  for 
system  changes  and  new  software  packages  and  features.  By  reading  this  document,  a  user  will 
learn  how  to  write  the  image  processing  command  portions  of  his  or  her  software.  Aoxirdingly, 
the  sections  of  this  document  reflect  divisions  based  on  intended  function,  i.e.,  I/O,  control  struc- 
tures, procedure  calls,  etc.  The  user  should  also  note  that  during  the  early  stages  of  development, 
this  document  doubles  as  the  vsh  specification.  For  this  reason  some  features  of  vsh  do  not  exist 
or  do  not  behave  as  described.  Differences  between  the  described  and  actual  system  will  be  found 
in  the  associated  document  "Known  Problems  in  vsh"  which  is  included  as  i^jpendix  D. 
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lOvervtew 

The  VICOM  is  an  image  processing  mini-cotqjuter  >*irich  can  act  as  a  slave  to  a  host  com- 
puter, in  our  case  a  VAX  117750.  The  VICOM  acquires,  digitizes  stores  and  manipulates  images. 
It  acts  according  to  instructions  that  it  receives  from  the  user.  The  VICOM  can  obtain  instructions 
from  the  VICOM  CONSOLE,  or  aaoss  a  serial  line  to  the  VAX.  In  the  normal  mode  of  opera- 
tion, software  operating  on  the  VAX  will  issue  commands  to  the  VICOM  across  the  serial  line. 
The  vsh  program  provides  a  convenient  environment  for  the  development  of  such  software. 

The  VICOM  also  communicates  with  the  host  VAX  across  a  parallel  port  with  direct  access 
to  both  the  VICOM  and  the  VAX  manory.  This  interface  is  used  for  image  data  transfer.  Vsh 
manages  image  transfers  between  the  VICOM  and  VAX  data  files. 

Figure  2.1  shows  the  VAX/ VICOM  configuration.  The  VICOM  user  terminals  are  termi- 
nals for  the  VAX  designated  for  use  with  the  VICOM  and  vsh.  Except  for  this  designation  they 
are  normal  VAX  terminals. 

Vsh  provides  an  environment  on  the  VAX  which  allows  the  user  to  issue  instructions  to  the 
VICOM  and  manipulate  images.  After  a  user  invokes  vsh  he  or  she  can  issue  vsh  instructions 
interactively  or  by  means  of  macro  files.  The  user  can  also  execute  VAX  programs.  There  are 
four  dasses  of  vsh  commands: 

(1)  VICOM  commands  are  insoructions  which,  after  symbol  substitution,  are  passed  directly 
to  the  VICOM,  and  are  interpreted  by  the  VICOM  (see  the  VICOM  Users'  Manual^ ); 

(2)  Installed  vsh  commands  are  commands  interpreted  by  vsh.    These  may  or  may  not 
involve  the  issuance  of  commands  to  the  VICOM; 

(3)  Macro  commands  are  used  to  invoke  a  macro  file  containing  vsh  commands,  thereby 
redirecting  the  vsh  command  input  stream  for  the  duration  of  the  macro  file;  and 

(4)  Shell  commands  are  requests  for  execution  of  a  VAX  program  and  are  passed  to  the  host 
shell. 

Vsh  can  be  invoked  in  two  ways.  From  within  the  standard  shell  (e.g.  csh),  vsh  is  simply  a 
program  executed  in  the  normal  manner.  A  user  can  also  invoke  vsh  from  within  programs  writ- 
ten in  the  languages  C,  FORTRAN,  or  Pascal.  To  write  image  processing  software,  a  user  must 
decide  wiiether  the  highest  level  of  the  software  will  be  written  in  commands  issued  to  vsh  (i.e.  a 
vsh  macro),  or  in  a  programming  language.  The  choice  will  generally  dq)end  on  the  complexity  of 
the  control  structures  required.  Ultimately,  the  choice  is  not  so  significant  since  the  two  structures 
for  user  programs  {vsh  macros  calling  VAX  programs  or  VAX  programs  invoking  vsh  commands) 
recursively  pass  from  one  to  the  other  with  ease,  however  the  user  should  give  some  thought  to 
the  basic  program  structure  early  in  the  program  design. 

The  basic  operation  of  vsh  is: 

Get  a  command  line  from  the  input  and  perform  symbol  substitution. 

Strip  the  first  word  (the  keyword)  from  the  command  and  determine  the  command  type. 

Pei-form  the  ^Jpropriate  actions  on  the  VICOM  and/or  VAX. 

This  is  rq)eated  until  an  end  or  quit  command  or  the  end  of  the  input  file  is  encountered.  To 
determine  the  command  type,  vsh  matches  the  keyword  against  a  list  of  VICOM  and  installed  vsh 
commands.  If  the  match  is  successful  the  appropriate  action  is  performed.  If  no  match  is  found, 
then  vsh  searches  for  a  macro  file  whose  name  matches  the  keyword  (with  the  extension  '.vc*).  If 
a  macro  file  is  found  then  vsh  accepts  commands  from  that  file.  Vsh  first  looks  in  the  current  user 
directory  for  the  macro  file  and  then  in  the  global  vsh  macro  library.  Finally,  if  no  match  is 
found,  the  command  is  assumed  to  be  a  VAX  program  or  shdl  command  and  is  passed  to  the 
shell  for  necution. 
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Figure  2.1.  VICOM/host  configuration. 
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3  VICOM,  vsh,  and  VAX  Usage 

TTiis  section  describes  the  baac  procedures  for  using  the  VICOM  with  vsh. 

3.1  Accounts 

In  order  to  use  the  VICOM  and  vsh,  you  will  need  an  account  on  CSDl,  one  of  the  com- 
puter science  department's  VAX  11/750's.  Accounts  will  be  provided  to  NYU  faculty,  staff,  and 
students  with  valid  reasons  for  using  the  VICOM.  CSDl  uses  the  UNIX  operating  system 
(currently  Berkeley  UNIX  version  4.2).  Manuals  describing  Berkeley  UNIX  are  available  in  the 
Courant  Institute  Library,  in  the  terminal  room  on  the  third  floor  of  Warren  Weaver  Hall,  and  in 
the  computer  vision  laboratory  on  the  12th  floor  of  715  Broadway.  Books  on  UNIX  are  available 
in  the  lAiiversity  Bookstore  and  many  other  bookstores. 

You  will  need  to  know  at  least  a  few  of  the  shell  commands,  an  editor,  and  probably  a  pro- 
gramming language  -  either  C,  FORTRAN,  or  Pascal.  The  shell  commands  are  documented  in 
volume  1  of  the  UNIX  manual.  Tlie  simplest  editor  to  learn  is  ed,  but  it's  more  desirable  to  use  vi 
or  emacs.  Tutorials  for  ed  and  vi  are  in  the  UNIX  manuals.  Many  sources  are  available  for  learn- 
ing C,  FORTRAN,  and  Pascal. 

You  will  also  .  -cd  to  know  the  VICOM  commands,  as  described  in  the  VICOM  Users' 
Manual.  A  copy  of  the  mnniml  will  be  found  in  the  Courant  Institute  library  and  in  the  computer 
vision  laboratory. 


3.2  Power-op 

In  order  to  use  the  VICOM,  a  user  must  turn  on  the  equipment  and  log  in  at  a  terminal 
designated  for  VICOM  users  at  the  computer  vision  laboratory.  Note  that  if  a  user  simply  wishes 
to  edit  files  or  execute  programs  that  do  not  use  vsh  or  the  VICOM,  any  terminal  connected  to  the 
Academic  Computing  Facility  switch  will  do. 

To  power  vp  the  system,  first  turn  on  the  power  strip  behind  the  terminals  and  turn  on  the 
terminals.  Second,  turn  on  the  circuit  breaker  on  the  back  panel  of  the  VICOM  Qower-left)  and 
press  the  on  button  in  the  front  of  the  VICOM.  Turn  on  the  video  monitor  with  the  white  switch 
on  its  front. 

If  a  camera  is  needed  it  must  be  turned  on  also.  The  vidicon  camera  (the  bdge  and  brown 
camera  near  the  terminals)  has  a  switch  at  the  top.  The  ccd  camera  (the  red  and  black  camera  on 
the  optical  table)  has  a  switch  on  its  power  supply  (a  smaD  box  connected  to  the  camera).  The  cod 
camera  works  best  if  it  is  allowed  to  warm  iqj  f or  30  minutes  or  so.  Only  one  camera  can  be  con- 
nected to  the  VICOM  at  a  time,  you  should  check  to  see  that  the  one  you  wish  to  use  is  con- 
nected. If  you  must  connect  a  camera,  there  are  three  cables  to  connect:  two  sync  cables  (vertical 
and  horizontal)  and  a  video  input.  The  cables  and  jacks  on  the  back  of  the  VICOM  are  labeled. 


3  J  Login 

Near  the  VICOM  in  the  computer  vision  laboratory,  there  will  be  one  or  more  VICOM 
users'  terminals,  and  perhaps  a  VICOM  console.  They  are  marked.  To  use  the  VICOM  and  vsh 
you  must  login  on  one  of  the  VICOM  users'  terminals. 
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3.4  Invoking  vsh  from  the  SheO 

Before  using  vsh,  the  VICOM  must  be  ready  to  accept  commands  from  the  VAX.  When 
the  VICOM  is  turned  on  or  reset  it  expects  commands  from  its  console.  The  prompt 

•> 

will  be  displayed  on  the  VICOM  console.  To  have  the  VICOM  acxxpt  commands  from  the  host 
you  must  press 

<es0-0 

on  the  VICOM's  console  (that's  the  escape  key  and  then  the  capital  O).  If  the  VICOM  console  is 
not  present  this  stqj  is  not  necessary.  When  the  VICOM  is  ready  to  accept  commands  from  the 
VAX  it  will  display  the  prompt 

+> 

on  the  VICOM  console.  The  VICOM  can  be  returned  to  its  initial  state  of  expecting  commands 
from  the  console  by  again  entering 

<es0-0 

on  the  VICOM  console.  Under  various  circumstances  (eg.  the  VICOM  gets  hung  or  crashes)  it 
may  become  necessary  to  perform  this  step  again.  In  any  case  the  prompt  '+>'  on  the  VICOM 
console  indicates  that  the  VICOM  is  ready  to  accept  commands  from  the  VAX. 

Once  the  VICOM  is  ready,  vsh  can  be  invoked  either  by  user  programs  or  from  the  UNIX 
shell.  The  use  of  vsh  from  the  user  program  is  described  in  Section  3.5.  To  execute  vsh  from  the 
host  shell,  enter  any  of  the  ctjmmands 

%vsh 

%vshp7  ...p9 

%  "v^ -l  filename  pi  ...  p9 

Vsh  will  respond  with  the  prompt 

•> 

on  the  VICOM  users'  terminal.  Commands  may  now  be  issued  to  vsh.  The  second  and  third 
forms  above  invoke  vsh  with  the  parameters  pi  ...  p9  at  the  top  level.  Parameters  are  described 
in  Section  5.2.  The  -f  option  in  the  third  form  directs  vsh  to  accept  commands  from  the  file 
filename  at  the  top  level. 

Vsh  will  not  run  if  you  are  not  at  a  VICOM  users*  terminal  of  if  the  VICOM  is  already  in 
use,  instead  it  will  give  you  a  message  indicating  what  the  problon  is.  In  some  situations  the 
parallel  connection  between  the  host  and  the  VICOM  can  not  be  established,  if  this  is  so  a  mes- 
sage will  be  printed.  In  this  case  the  VICOM  will  still  accept  commands  from  the  host  but  images 
can  not  be  transferred. 

Vsh  will  accept  VICOM  commands,  vsh  commands  and  shell  commands.  VICOM  commands 
can  be  entered  exactly  as  described  in  the  VICOM  Users'  Manual  except  that  commands  must  be 
entered  b  lower  case.  Other  commands  are  described  in  the  remaining  sections  of  this  document. 

Figure  3.1  gives  a  summary  of  the  complete  power-up  and  login  procedure. 

3.5  Invddng  vsh  from  User  Programs 

Vsh  commands  can  be  executed  from  within  users'  programs  written  in  C,  FORTRAN,  or 
Pascal.  Before  a  program  using  vsh  is  run  the  VICOM  must  be  prepared  as  above,  that  is, 
<esc>-0  must  be  entered  on  the  VICOM's  console.  In  addition  the  vshJVlCOM  connection  must 
be  opened  by  the  following  statement: 
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1.  Power  strip  (and  terminals)  on. 

2.  VICOM  main  power  on. 

3.  VICOM  front  panel  on. 

4.  Video  monitor  on. 

5.  Camera  on  and  connected,  if  necessary. 

6.  <es0-0  on  the  VICOM  console  until '+ >*  is  displayed. 

7.  Login  to  the  VICOM  users*  terminal. 

8.  Execute  vsh  or  user's  program. 


Figure  3.1.  Power-up  and  login  procedure. 


ire  =  vopenQ 
Vopen  and  all  (except  ▼eirdesc)  the  routines  in  this  section  are  integer  valued  functions  whidi 
retiim  a  code  number  indicating  errors  or  failures  during  execution.  The  error  code  is  zero  if  the 
routine  executes  without  error.  Other  error  codes  are  listed  in  Appendix  C. 

Note  that  in  the  examples  given  in  this  section  the  language  is  not  specified.  Excqjt  for 
minor  syntactical  differences  (eg.  sani-colons  or  character  case)  the  routines  are  invoked  in  the 
same  manner  in  C,  FORTRAN,  and  Pascal.  Unless  the  differences  are  substantial  or  significant  a 
generic  example  will  be  used  throughout  this  document,  leaving  it  to  the  user  to  transliterate  the 


/•  usevsh.c  •/ 
#include  <stdio.h> 
#indude  <vsh.h> 


mainQ 
{ 


mt      irc, 

char     command  [VCLEN]; 

if  (irc  =  vopenQ) 

printf("%sO,  verrdesc(irc)); 
else 

{ 

v/tilc  (gets(command)  1=  NULL) 

if  (irc  =  vsh(command))  printf("%80,  verrdesc(irc)); 
vdoseO; 

} 


Figure  3.2.  Example  use  of  vsh  in  C. 
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statement  into  the  appropriate  form  for  the  language  used. 

To  invoke  a  vsh  cxwnmand,  call  the  function  vsh  as  follows: 

ire  =  vsh(command) 

wiiere  command  is  a  character  string  containing  a  single  vsh  command.  Vsh  is  an  integer  valued 
function  which  returns  a  code  number  indicating  the  errors  encountered  during  the  processing  of 
command.  A  series  of  vsh  commands  can  be  executed  by  repeatedly  invoking  vsh,  or  by  passing  a 
macro  command  to  vsh. 

If  the  programmer  knows  that  the  command  to  be  executed  at  a  certain  point  of  a  program 
will  always  be  a  VICOM  command  then  the  vkom  routine  can  be  used.  The  format  is 

ire  =  vicom(comma7u/) 

This  will  execute  considerably  faster  than  the  vsh  routine.  It  returns  an  error  code  as  above. 

Two  additional  routines  are  useful.  Vckne  terminates  access  to  vsh  and  the  VICOM.  It  is  a 
subroutine  invoked  as  follows: 

vcloseO  in  C  and  Pascal 

call  vclose       in  FORTRAN 

Verrdeac  is  given  an  integer  error  code  returned  by  a  vsh  routine  and  returns  a  character  string 
containing  a  description  of  the  error.  The  purpose  is  to  provide  a  message  that  can  be  shown  to 
the  user  to  indicate  the  source  of  an  error. 

Figures  3.2,  3.3  and  3.4  are  examples  of  programs  in  C,  FORTRAN,  and  Pascal  that  use 
vsh,  respectively.  The  programs  are  equivalent  each  opens  the  vsh/VlCOM  connection  and  then 
accepts  commands  and  passes  them  to  vsh  until  the  end  of  input  is  encountered.  A  description  of 
any  vsh  error  is  displayed.  The  constant  VCLEN  is  the  limit  on  size  of  commands  accepted  by 
the  VICOM  In  the  PEiscal  program  the  data  types  'vstring'  and  Vstringpointer'  are  defined  m  the 
include  file.   The  type  Vstring'  is  an  array  of  characters  for  holding  commands  or  VICOM  error 


program  usevsh 
parameter  (VCLEN  =  75) 
integer  ire 

character*  (VCLEN)  command 
integer  vopen,  vsh 
character*  (VCLEN)  verrdesc 

ire  =  vopenQ 

if  (ire  .ne.  0)  print*,  verrdesc(irc) 
100     read  (5,  '(a)',  end=900)  command 
ire  =  vsh(command) 
if  (ire  .ne.  0)  print*,  verrdesc(irc) 
goto  100 
900     continue 
call  vdose 
end 


Figure  3.3.  Example  use  of  vsh  in  FORTRAN. 
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program  usevsh  (input,output); 
#indude  7a/robotics/h/vshpas.h"; 
var      ire:  integer; 

command:  vstringpointer; 

procedure  getcommand  (command:  vstringpointer); 
var      i:  integer; 

begin 

i:=l; 

while  not  eoln  do  begin 
read  (command'  [i]); 
i  :=  i  +  1; 
end;    . 
readln; 

command'  [i]  :=  chr(0);  {Necessary  terminator.} 
end; 

procedure  puterror(errormess:  vstringpointer); 
var      i:  integer; 

begin 

i  :=  1; 

while  errormess*[i]  <>  chr(0)  do  begin 
write(errormess*[i]) ; 
i  :=  i  +  1; 
end; 
writeln; 
end; 

begin 

ire  :=  vopen; 

if  ire  <>  0  then  puterror(verrdesc(irc)) 

else  begm 

new  (command); 
while  not  eof  do  begin 

getoommand(command) ; 
ire  :=  vsh  (command); 
if  ire  <>  0  then  puterror(verrdesc(irc)); 
end; 
vdose; 
end; 
end. 


Figure  3.4.  Example  use  of  vsh  in  Pascal. 


messages  and  Vstringpointer'  is  a  pointer  to  a  variable  of  type  Vstring'. 
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The  various  vsh  and  VICOM  routines  described  in  this  document  are  available  in  the  vsh 
library.  To  access  the  library  include  the  '-Iv'  option  in  the  compile  or  load  statement  for  the  pro- 
gram. The  following  examples  illustrate  this. 

%  cc  vis.c  -Iv 
%  f77  usevsh.f  -Iv 
%  pc  usevsh.p  -Iv 
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4  VICOM  Commands 

VICOM  commands  will  be  accepted  by  vsh.  These  commands  are  described  in  the  VJCOM 
Users'  Manual.  Tlie  command  keyword  (first  word)  must  be  in  lower  case.  VICOM  commands 
are  listed  alphabetically  in  Appendix  A,  and  grouped  according  to  functional  groups  in  Appendix 
B. 

Some  features  and  bugs  in  VICOM  commands  that  are  not  adequately  presented  in  the 
manual  will  be  discussed  in  the  foDowing  sections. 


4.1  Constants 

Many  commands  accept  constants  as  parameters.    Typically  constants  are  specified  in 
decimal  form.  For  example 

0.5 

-.231 
-0.12 

Decimal  constants  are  always  in  the  range  -1.0  to  1-2"^.    Alternatively,  constants  can  be 
expressed  by  four  hexadecimal  digits,  foDowed  by  the  letter  capital  'H*.  Examples  are 

8000H  (equivalent  to -1.0) 

C3F2H 

4000H  (equivalent  to  0.5) 

7FFFH  (equivalent  to  1-2"'-') 


4.2  Pixel  Size 

A  fully  populated  image  has  16  bits  per  pixel,  12  for  the  image  and  4  for  graphics.  For  the 
most  part,  the  arithmetic  commands  use  only  the  12  image  bits  but  some  operate  on  the  entire  16 
bit  words.  The  adk  (add  constant)  operates  on  16  bit  quantities.  The  manual  implies  that  the 
shift  commands,  hh  an  ash,  work  on  the  full  16  bits,  this  is  not  true.  It  is  apparently  impossible 
to  achieve  16  bit  arithmetic  to  any  significant  degree. 


4.3  The  cam  Command 

The  rntn  command  allows  the  user  to  view  in  real-time  the  camera  input  to  the  VICOM, 
Its  primary  purpose  is  to  allow  the  user  to  prqsare  a  scene  before  it  is  captured  via  the  dig  com- 
mand. It  is  not  necessary  to  invoke  cam  before  csqmiring  an  image  if  the  scene  is  already 
prepared.  While  the  cam  command  is  in  effect  the  user  should  avoid  performing  unnecessary 
commands  —  in  particular  commands  using  the  cursor  or  bitpad.  Too  much  activity  while  the  cam 
command  is  in  efifect  can  have  undesirable  affects  including  causing  the  VICOM  to  crash. 


4.4  Acquiring  Images 

"Ihe  VICOM  can  digitize  a  video  signal  to  obtain  a  512  by  512  by  right  bit  image.  Gen- 
erally, a  macro  will  be  used  for  this  purpose  (see  Figure  5.2).  However,  for  completeness,  we 
describe  some  of  the  technical  issues  in  this  section. 

The  camera  must  be  turned  on  and  connected  to  the  VICOM.  The  vidicon  camera  has  a 
lens  cover  which  should  be  placed  on  the  camera  when  it  is  not  in  active  use.  A  scene  can  be 
burned  permanently  into  the  vidicon  tube  if  it  is  left  looking  at  the  same  scene  for  too  long.  This 
is  true  even  if  the  camera  is  not  turned  on. 
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To  view  a  scene  from  the  camera  in  real-time  the  following  commands  should  be  issued: 

•>  int 

•>  disA 
•>  camA 

A  signifys  one  of  the  VICONTs  images  (A  =  1,  2,  ...)•  The  bt  loads  the  YICONrs  display  tables 
so  that  the  appears  correct  during  the  cam  command.  The  db  command  causes  the  indicated 
image  to  be  displayed  and  the  cam  command  causes  the  video  signal  from  the  camera  to  be  con- 
tinuously digitized  and  placed  in  the  indicated  image.  The  scene  is  now  being  displayed  in  real- 
time, the  user  can  adjust  the  camera  or  scene  as  desired.  These  first  three  steps  in  acquiring  an 
image  are  solely  for  the  user's  convenience  and  do  not  effect  the  acquired  image.  While  the  cam 
command  is  in  effect  the  user  should  avoid  extensive  use  of  other  VICOM  commands,  particularly 
cursor  and  bitpad  commands.  Simultaneous  use  of  the  cursor  and  the  cam  command  can  cause  the 
VICOM  to  behave  erratically  and  sometimes  crash. 

To  actually  capture  an  image  issue  the  command 

•>  dig  A 

where  A  is  an  image.  This  places  the  image  data  m  the  high  order  8  bits  of  the  indicated  image. 

Interpreting  the  8  bits  of  captured  data  as  an  unsigned  integer,  we  have  0  indicating  the 
lowest  intensity  and  255  as  the  maximum.  The  VICOM  processors  interpret  the  pixel  data  dif- 
ferently. They  interpret  the  high-order  twelve  bits  of  the  pixel  as  a  two's  complement  fraction, 
that  is  as  a  signed  number  in  the  range  -1.0  s  a:  <  1.0.  If  we  interpret  the  captured  data  this 
way,  an  intensity  value  of  0  corresponds  to  an  interpreted  value  of  0,  a  midrange  intensity  of  127 
corresponds  to  the  maximum  two's  complement  fraction  of  almost  1.0,  the  next  intensity 
corresponds  to  —1.0,  and  the  highest  intensity  value  of  255  corresponds  to  almost  zero  (-1/128). 
Obviously,  we  want  to  convert  from  the  input  representation  to  the  computational  rqjresentation. 
This  is  done  with  the  following  command: 

•  >  two  A  >  A 

wWch  converts  the  input  intensities  to  the  range  0  to  255/256  in  the  two's  complement  form.  No 
precision  is  lost  in  this  conversion  since  the  VICOM  actually  has  12  bits  for  the  data  in  each  pixel. 
At  this  point  the  display  tables  should  be  reset  to  their  original  state.  To  do  this  issue  the  com- 
mand 

•>  res 

Figure  4.1  shows  the  steps  to  capture  an  image. 


•>  int 

•>  disA 

•>  cam  A  At  this  point  set  the  scene. 

•>  dig  A 

•>  twoA  >  A 

•>  res 


Figure  4.1.  Step  to  digitalize  image. 
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Two  further  notes  are  worth  mentioning.  One  is  that  image  acquisition  works  only  with  full 
size  (512  by  512)  images.  The  system  will  not  objert  to  different  memory  configurations  but  the 
acquired  image  will  always  be  512  by  512  pixels.  The  second  is  that  it  is  possible  to  get  more  pre- 
cision in  the  acquired  image  by  averaging  several  images  together. 


4.5  The  Value  1.0 

Tlie  two's  complanent  interpretation  of  pixel  values  used  by  the  VICOM  has  no  value 
exactly  equal  to  1.0.  The  nearest  value  is  1-2"^^  or  2047/2048.  This  is  true  in  pixel  values,  con- 
volution masks,  and  arithmetic  or  logical  constants.  For  instance,  the  mok  (multiply  by  constant) 
with  constant  of  1.0  actually  causes  a  slight  decay  of  the  image.  For  occasional  usage  this  is  not 
too  serious,  however,  in  iterative  procedures  this  can  be  a  disaster.  A  possible  solution  is  to 
change  the  procedure  to  use  -1.0  instead  of  1.0  since  the  number  -1.0  exists  in  the  two's  com- 
plement interpretation. 

4.6  Using  the  Cursor 

The  bitpad  can  be  used  to  control  the  VICOM's  cursor.  Two  stqss  must  be  performed 
before  the  bitpad  can  be  used,  they  are: 

•>  dev  (1) 
•>  wrp 

The  first  enables  input  from  the  bitpad,  the  second  write  protects  the  graphics  nibble  of  the  imag 
planes.  These  stq3s  need  only  be  performed  once  after  the  VICOM  is  turned  on  or  reset.  -Nc 
the  command 

•>  curA 

will  display  the  cursor  in  image  A.  Press  the  stream  button  the  bitpad  and  the  cursor  will  follow 
the  bitpad's  mouse.  Press  the  switched  stream  button  and  the  cursor  will  foUow  the  mouse  when 
the  mouse's  button  is  pressed-  Press  the  point  button  and  the  cursor  will  jump  to  the  current  posi- 
tion of  the  mouse  when  the  mouse's  button  is  pressed.  The  cursor  normally  is  in  the  red  gra^)hics 
plane  (this  can  be  changed,  see  the  cor  command  in  the  VICOM  manual)  and  can  be  moved  about 
without  changing  the  image  data,  if  however,  there  graf)hics  data  in  the  red  plane  then  the  cursor 
win  alter  the  data  as  it  passes  near  a  pixel. 

When  commands  that  use  the  cursor  such  as  tra  (for  trace)  or  per  (for  print  cursor)  are  exe- 
cuted vsh  stops  accepting  input  from  the  user's  terminal,  it  expects  ii^t  from  the  bitpad.  Place 
the  bitpad  in  stream  mode  and  the  cursor  will  follow  the  mouse.  Press  the  mouse's  button  and 
move  the  mouse  and  the  appropriate  action  will  be  done  (i.e.  tracing  or  printing).  To  exit  the 
command,  put  the  bitpad  in  point  mode  and  press  the  button  on  the  mouse  (it  may  take  several 
presses),  vsh  should  respond  with  its  prompt. 

The  bitpad  donands  a  lot  attention  from  the  VICOM's  central  processor.  For  this  reason  it 
is  wise  to  "quiet  the  bitpad"  when  it's  not  in  use.  To  do  this  first  press  the  point  or  reset  button 
on  the  bitpad  and  or  move  the  mouse  off  the  bitpad  working  area.  If  you  are  done  using  the  bit- 
pad  for  the  session  the  following  commands  ranove  the  cursor  and  disable  the  bitpad: 

•>  curA  (1,1,0) 
•>  dev  (0) 

where  A  is  the  image  containing  the  cursor. 
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SMacroFOes 

One  way  to  write  software  for  the  VICXDM  is  to  create  macro  files.  A  macro  file  contains  a 
sequence  of  commands  similar  to  scripts  or  commands  files.  Parameters  can  be  passed  to  macro 
files,  and  will  be  substituted  in  the  commands.  Very  simple  control  features  are  provided,  but  are 
kept  extremely  simple  for  effideiKy  reasons.  A  macro  can  contain  any  sequence  of  commands 
which  can  be  interpreted  by  vsh. 

5.1  Invokfaig  Macro  Files 

Macro  files  can  be  invoked  in  two  ways: 

»>  filename  pi  ...  p9 
•>  da  filename  pi  ...  p9 

The  two  forms  are  essentially  identical.  Here  filename  is  the  path  to  a  file  named  filename.vc. 
The  symbols  pi  ...  p9  stand  for  zero  or  more  argument  strings  which  will  be  substituted  for 
corresponding  parameter  symbols  in  the  macro  file  (see  below).  Macro  files  are  sometimes  called 
"chain  files"  for  historical  reasons.  This  explains  the  derivation  of  the  cha  command.  In  the  first 
form  filename  must  not  conflict  with  any  VICOM  or  installed  vsh  command;  in  the  second  form 
this  restriction  does  not  apply.  11  filename  already  contains  an  extension  (i.e.  there  is  a  '.'  in  the 
name)  the  extension  '.vc*  is  not  ^jplied.  Vsh  first  searches  in  the  current  working  dirertory  for  a 
macro  file  and  then  in  a  global  directory  defined  by  vsh,  called  the  vsh  macro  directory.  Your 
working  directory  will  contain  macros  which  you  have  developed  for  your  own  use,  whereas  the 
vsh  macro  directory  contains  macros  of  more  general  use,  some  of  which  are  described  in  this 
document.  You  may  list  the  contents  of  the  vsh  macro  directory,  and  read  the  files  in  that  direc- 
tory, in  order  to  learn  of  macros  not  described  in  this  document.  In  order  to  print  the  path  name 
of  the  vsh  macro  directory,  issue  the  installed  command 

•>  pvd 

Esamples  of  macros  are  shown  in  Figures  5.1  and  5.2.    These  macro  files,  sobeLvc  and 
snap.vc  can  be  invoked  as  in  the  following  exan^^les: 

•>  cha  sobel  12  3  4 
•>  sobel  2  3  11 
•>  snap  1 
•>  dia  snap.vc  4 


5.2  Parameten 

Parameters  can  be  passed  to  a  macro  file,  or  to  vsh,  or  to  an  invocation  of  vsh  (see  section 
5.4).  Parameters  are  given  on  the  command  line.  Thus  the  command 

•>  cba  filename  pi  p2  ...  p9 

invokes  the  raacro  filename  with  the  parameters  pi  p2  ...  p9  which  will  be  used  for  substitution  in 
the  macro. 

Parameters  are  words  (sequences  of  Asdi  characters)  sqjarated  by  spaces,  commas,  or  other 
punctuation  (except  '_',  '•*,  '•'.  and  '•'  which  are  treated  as  letters).  Parameters  can  contain 
embedded  spaces,  commas  or  other  delimiters  provided  the  entire  parameter  is  enclosed  in  single 
or  double  quotes  (wiiich  are  not  part  of  the  parameter).  There  can  be  i^  to  9  parameters  on  a 
command  line. 

The  parameter  values  for  pi,  p2,  ...,  p9  are  substituted  for  the  symbols  %1,  %2,  ...,  %9 
respectively,  in  the  macro.  Thus  every  occurrence  of  the  character  sequence  %1  is  rqilaced 
entirely  by  the  complete  word  specified  by  p7  in  the  cha  command.  In  general,  %n  is  replaced  by 
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sobel  A  B  C  D 

detects  edges  using  the  Sobel  operator. 

A  source  image. 
B,C  work  images. 
D        destination  image. 

Note:  A  must  be  distinct  from  B  &  C 


mas  %1>%2  (13) 
mag  %2>%2 
mas  %1>%3  (15) 
mag  %3>%3 
add  %2,%3>%4 
Ish  %4>%4  (-3) 


Figure  5.1.  Sample  chain  file,  sobeLvc. 


•  snap  A 

•  Takes  a  snapshot 
• 

•  A        Image  to  receive  the  picture. 
int 

dis%l 

cam  %1 

.  Say  cheeeese,  then  press  *D. 

dig  %1 

two  %1>%1 

res 


Figure  5.2.  Chain  file  to  take  a  snapshot,  snap.vc. 


the  n*  parameter,  where  n  =  1,  2,  ...,  9.  Within  the  macro  the  symbol  %0  (percent  zero)  is 
replaced  by  the  name  of  the  macro  file  (actually  the  first  word  of  the  command  line  excluding 
cha). 

The  parameters  (eg.  %7)  may  appear  in  any  location  of  a  macro  file.  The  symbol  is  com- 
pletely repiacsd  by  the  entire  character  sequence  of  the  corresponding  argument.  The  parameters 
can  represent  image  numbers,  constants,  file  names,  keywords,  portions  of  file  names,  image  file 
names,  programs,  parameters  to  programs,  parameters  to  other  macros,  etc. 

Figures  5.1  and  5.2  show  macro  files  with  parameters.  The  lines  beginning  with  '•'  are  com- 
ments and  are  ignored  by  vsh.  All  symbols  of  the  form  %n,  wdiere  n,  is  a  digit,  will  be  replaced 
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by  the  parameters  in  the  call  to  the  macro  file. 

5.3  De&iiltiiig  Parameter  Values 

If  a  parameter  is  not  defined  when  a  macro  (or  vsh  level)  is  invoked  then  the  corresponding 
symbol  (%n  where  n  =  1,  2,  ...,  9)  is  generally  replaced  by  the  empty  string  when  it  is  encoun- 
tered in  the  macro.  Default  values  for  missing  parameters  can  be  specified  within  a  macro  via  the 
de&ult  statement.  The  form  is 

•>  default  p7p2  ...  p9 

The  delimiters  between  parameter  values  are  exactly  as  described  for  a  macro  invocation.  The 
parameters  are  specified  in  the  same  order  as  in  the  maao  invocating  statement  and  empty 
defaults  can  be  specified  just  as  empty  arguments  are  specified  (see  Section  5.2).  Multiple  default 
statements  within  a  macro  are  allow«l,  the  most  recent  default  value  for  a  particular  is  parameter 
is  always  used. 

The  parameter  value  corresponding  to  %n  is  deemed  to  be  missing  if  there  are  fewer  than  n 
parameters  in  the  invocation,  or  if  the  n'*  parameter  is  the  empty  string  delimited  by  commas  or 
other  non-blank  delimiters.  For  example  the  third  parameter  (%3)  is  missing  from  the  following 
invocations: 

•>  macrofile  parml  j)arm2 

•>  macfile2  (pi,  p2)  (p4,  p5,  p6) 


5.4  Nesting  of  Macro  Calls 

Macro  file  calls  can  be  nested.   There  is  a  restriction  on  the  depth  of  nesting  tied  to  the 
number  of  open  files  or  descriptors  that  a  process  may  have  at  one  time. 

Conceptually,  it  is  convenient  to  say  that  vsh  is  always  processing  a  maao  file.  When  vsh  is 
invoked  by  the  shell,  the  current  'macro  file'  is  usually  the  standard  input  (which  in  turn  is  usually 
the  user's  terminal).  Vsh  processes  this  input  essentially  the  same  as  from  any  macro  file.  When 
the  user  invokes  a  macro  file,  a  new  level  of  vsh  is  created  with  its  own  source  of  input.  This 
input  is  processed  until  an  end  of  input  is  encountered,  at  which  time  control  is  returned  to  the 
higher  level  which  continues  processing  from  its  input  source.  It  is  possible  from  within  a  macro 
file  to  invoke  a  level  of  vsh  that  gets  its  input  from  the  user's  terminal  (or  more  correctly  the  top 
level  standard  input);  this  is  done  via  the  pause  commands  described  below.  We  will  use  the  inter- 
changeable terms,  "macro  fDe  level",  "source  input  level",  or  singly  "vsh  level"  to  refer  to  this 
nesting  of  vsh  invocations. 

The  important  points  here  are  that  generally,  what  is  true  for  maao  file  invocations  is  true 
at  any  vsh  level  and  that  one  level  of  vsh  must  complete  before  the  invoking  level  continues. 
When  the  ii^t  to  vsh  is  a  terminal  there  are  some  differences.  One  is  that  vsh  prompts  for  input 
on  terminals  and  the  other  is  that  errors  are  rqxnted  to  source  terminals  as  human  readable  mes- 
sages and  do  not  cause  the  vsh  level  to  terminate. 

5.4.1  Pause  Conunands.    The  pause  command  has  three  forms: 

.  message. 
-  message, 
pau  message. 

where  message  stands  for  any  character  string.  A  pause  command  first  displays  message  and  then 
invokes  a  new  vsh  level  with  the  standard  input  as  the  source.  The  primary  function  of  the  pause 
commands  is  to  allow  interactive  control  during  the  processing  of  a  macro  file.  Processing  returns 
to  the  invoking  level  when  the  invoked  level  of  vsh  is  terminated  with  a  *D,  end,  or  quit  command 
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(see  Section  5.5). 

In  a  user's  program  the  statement 

i  =  vsh(".") 

invokes  vsh  with  the  standard  input  (usually  the  user's  terminal)  as  the  source.  The  user  is  then 
free  to  perform  vsh  commands.  When  the  user  terminates  the  vsh  level  control  is  returned  to  the 
user's  fjrogram. 

Figure  5.2  contains  an  sample  macro  file,  snap.vc,  that  will  digitize  an  image  into  a  given 
image  buffer.  Snap.vc  first  sets  vp  the  VICOM  so  that  the  camera  image  is  displayed  in  the 
desired  image.  Then  the  pause  command 

is  executed,  and  the  prompt  "Say  cheese,  then  press  *D"  is  displayed  on  the  VICX)M  user's  termi- 
nal, foDowed  by  a  prompt  like 

At  this  point  the  scene  should  be  prepared.  The  user  can  use  any  vsh  command,  including  bvok- 
ing  macro  files.  When  the  scene  is  prqjared  the  user  terminates  the  pause  vsh  level  with  a  'D, 
end,  or  quit  command.  Snap.vc  then  continues  with  the  dig  command. 

When  the  source  input  to  a  vsh  level  is  a  terminal  vsh  prompts  for  the  input.  The  number  of 
asterisks  in  the  prompt  indicates  the  vsh  level.  The  top  level  pron^  for  vsh  is  '•>'  at  deeper  lev- 
els there  are  more  asterisks,  for  example  '•••>*  at  the  third  level.  The  purpose  is  to  remind  the 
user  of  the  dqnh  of  nesting. 

5.4.2  Scope  of  Parameters.  The  parameters  passed  to  a  vsh  level  are  available  only  to  that  level. 
If  a  new  level  is  invoked  the  parameters  current  at  the  time  of  invocation  are  pushed  onto  a  stack 
and  are  replaced  by  new  parameters.  When  control  returns  to  the  original  level  its  parameters  are 
restored  from  the  stack. 

Parameter  substitution  is  the  first  action  performed  on  the  command  line.  It  is  performed 
on  the  line  as  a  wliole  without  respect  to  word  boimdaries  or  command  line  syntax.  Substitution 
may  be  performed  in  the  keyword  of  a  command.  Arguments  may  be  concatenated  and  the  result 
is  that  the  corresponding  parameter  symbols  are  concatenated.  Parameter  values  may  be  passed  to 
deqjer  levels  by  including  the  symbok  which  are  substituted  by  the  parameters  among  the  param- 
eter list  invoking  the  next  level,  as  in 

•>  cha  macro  %3  %2 


5.5  Macro  Flk  Tennhiation 

A  nesting  level  is  terminated,  and  control  is  passed  to  the  level  immecfiately  above,  upon 
execution  of  an  end,  quit,  or  EOF  command.  A  source  level  is  also  terminated  by  the  end  of  the 
source  file  or  a  *D  on  the  terminal.  Of  course,  termination  of  the  top  level  vsh  terminates  vsh 
entirely.  When  vsh  is  invoked  from  a  user's  program,  for  example 

i  =  vsh(command) 

it  terminates  vslien  the  command  is  complete.   If  the  command  invokes  a  macro  file  (or  is  a  pause 
command)  vsh  terminates  v/hea  the  macro  file  terminates. 


vsh  Users'  Manual  Macro  Files  17 


5.6  Comments 

Any  command  with  a  '•*  or  '#'  in  the  first  column  is  a  comment  and  is  not  parsed  or  exe- 
cuted. If  the  command  line  begins  with  '••'the  line  is  a  comment  which  will  always  be  displayed 
on  the  user's  terminal.  This  is  true  even  if  set  notrace  is  active  (see  Section  5.8.1).  This  allows 
the  user  to  provide  a  commentary  during  the  execution  of  a  macro  file. 


5.7  Do  comnumd 

The  do  command  is  a  simple  control  command  which  enables  repeated  execution  of  a  com- 
mand. The  format  is 

•>do  n  command 

where  n  is  the  number  of  times  that  the  command  command  is  to  be  repeated.  Command  can  be 
any  vsh  command  (including  do).  The  do  will  be  prematurely  terminated  if  an  error  occurs  during 
the  execution  of  command. 


5.8  Set  CommaiMl 

The  set  command  allows  vsh  processing  options  to  be  set  or  reset.   There  are  two  options 
described  in  this  section,  they  are  trace  and  stqj. 

5.8.1  Tradiig  Macro  FOes.  It  is  sometimes  desirable  to  have  the  commands  of  a  macro  file 
displayed  as  they  are  performed.  This  can  be  done  by  issuing  the  following  command 

•>  set  trace 

This  causes  all  commands  at  this  level  and  deeper  levels  to  be  displayed  on  the  VICOM  users*  ter- 
minal while  they  are  processed.  The  displayed  commands  are  preceded  on  the  display  by 

fiUname> 

•what  filename  is  the  name  of  the  macro  file  in  which  the  command  is  contained. 

The  trace  can  be  turned  off  by 

•>  set  notrace 

5.8.2  Single  Step  Procesdng.  In  the  single  step  mode  vsh  displays  each  line  of  a  maao  file 
before  executing  it  and  waits  for  input  from  the  user's  terminal.  If  an  empty  line  is  entered  (i.e. 
just  a  <retum>),  vsh  executes  the  command  and  goes  to  the  next  command,  which  is  displayed 
and  so  on.  Any  other  input  line  is  treated  as  a  vsh  command  and  is  executed  and  vsh  again  waits 
for  ii^t.  This  continues  with  the  original  macro  file  command  suspended  until  an  empty  line  is 
entered.  Once  entered,  the  single  stq)  mode  applies  to  the  current  macro  level  and  deeper  levels, 
except  at  levels  vsiiich  recdve  input  from  a  terminal.  Single  step  mode  can  be  entered  and  exited 
via  the  step  command  as  follows: 

•>  set  step 
•>  set  nostep 
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5.8.3  Asynchronous  Operation.  In  ncjrmal  operation  vsh  issues  commands  to  the  VICOM  and 
then  waits  for  the  VICOM's  response.  Tlie  command 

•>  set  async 

puts  vsh  in  the  asynchronous  mode.  Commands  are  issued  and  responses  received  in  an  asynchro- 
nous manner.  This  speeds  up  the  processing  of  maao  files,  but  as  a  result  the  direct  correlation 
between  the  commands  and  their  respxsnses  (in  particular  errors)  is  lost.  The  asyndironous  mode 
also  effects  the  use  of  vsh  from  users'  programs.  In  asynchronous  mode  a  call  to  vsh  or  vkom  will 
normally  return  immediately  indicating  no  error,  however  an  error  condition  resulting  from  the 
current  command  may  be  reported  upon  return  from  a  later  call  to  one  of  the  routines.  For  this 
reason  the  asynchronous  mode  should  be  avoided  until  a  program  is  throughly  debugged.  In  addi- 
tion certain  interactive  commands,  for  example  per  and  roa,  always  operate  in  synchronous  mode. 
The  synchronous  mode  of  operation  can  be  restored  by  the  command 

•>  set  sync 


5.9  Errors  and  Interrapts 

When  an  error  occurs  in  a  vjA  or  VICOM  command  that  the  user  has  entered  on  the  termi- 
nal, vsh  responds  with  an  error  message  that  should  indicate  the  problem. 

When  an  error  occurs  during  the  execution  of  a  macro  file  with  input  from  a  source  other 
than  a  terminal,  the  macro  file  is  terminated  and  the  error  is  passed  to  the  vsh  level  that  invoked 
the  macro.  This  level  will  also  terminate  if  its  input  is  not  tram  a  terminal  and  so  on  until  the 
error  reaches  a  vsh  level  that  has  a  terminal  for  input.  At  this  point  the  appropriate  error  message 
is  displayed.  In  short,  an  error  during  the  processing  of  a  macro  file  causes  vsh  to  return  control 
to  the  nearest  level  receiving  commands  from  a  terminal. 

If  the  user  sends  an  interrupt  signal  to  the  vsh  process  (usually  done  by  typing  *C),  an  error 
is  forced  in  the  current  vsh  command.  Thus  an  interrupt  causes  vsh  to  return  to  the  nearest  level 
recdving  commands  from  a  terminal.  When  vsh  is  waiting  for  an  instruction  from  a  terminal  an 
interrupt  will  cause  the  current  level  to  terminate  with  an  error,  thus  causing  control  to  return  to 
the  next  level  with  a  terminal  as  input. 

The  stop  signal  (usxially  sent  by  typing  *Z)  causes  an  asynchronous  pause.  The  effect  is  that 
vsh  will  invoke  a  new  level  of  vsh  with  the  standard  ii^t  as  the  source  at  the  next  convenient 
point  (usually  the  completion  of  the  current  instruction).  The  user  can  then  enter  vsh  commands. 
When  the  new  vsh  level  is  terminated  control  returns  to  the  previous  level  at  the  point  it  was  inter- 
Tvpted.  This  provides  a  way  of  temporarily  stopping  execution  of  a  macro  file,  interactively 
inserting  vsh  commands,  and  resuming  execution  at  the  place  where  the  macro  was  suspended. 
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6  SheO  Commands 

Executable  programs  can  be  invoked  from  vsh.  The  formats  are 

»>  prog  pi  p2  ...  p9 
•>  ex  prog  pi  p2  ...  p9 

wiiere  prog  is  the  name  of  the  program  and  pi  p2  ...  p9  are  parameters  to  be  passed  to  the  pro- 
gram. The  keyword  ex  is  optional;  however,  if  it  is  not  used,  prog  cannot  conflict  with  any 
VICOM  or  vsh  command  or  any  of  the  available  macro  files.  The  available  macro  files  include 
the  macro  files  in  the  current  working  directory  and  those  in  the  global  vsh  macro  file  directory. 
The  ex  form  is  also  preferable  because  it  is  sli^tly  faster.  If  the  ex  keyword  is  missing  vsh  must 
search  the  directories  for  available  macro  fDes  before  determining  that  prog  is  an  executable  pro- 
gram. The  ex  keyword  immediately  signifies  an  executable  program  and  thus  eliminates  the 
search. 
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7  Image  I/O 

Image  data  can  be  stored  in  VICOM  image  memories,  files  on  VAX  storage  media,  and 
arrays  or  buffers  in  the  user's  program.  This  section  describes  how  the  user  can  transfer  image 
data  between  the  various  media. 

A  VAX  file  is  usually  a  file  on  the  disk,  either  in  the  user's  current  working  directory,  or  the 
vsh  image  directory.  However,  a  VAX  file  might  also  be  a  tape  file,  or  located  on  some  other 
device.  Vsh  allows  one  to  transfer  data  between  the  VICOM  image  memories  and  VAX  files  by 
using  vsh  commands.  These  commands  are  described  in  Section  7.1. 

Procedures  exist  to  facilitate  the  transfer  of  image  data  between  program  arrays  or  buffers 
and  external  media  such  as  VAX  files  or  VICOM  ^mage  memories.  These  procedures  are  avail- 
able in  C,  FORTRAN,  and  Pascal  and  are  described  in  Section  7.2. 

To  communicate  with  VICOM  image  memory  and  VICOM  look-up-tables,  the  procedures 
use  names  for  VICOM  buffers  which  make  them  look  like  UNIX  special  fDes.  The  names  are 
listed  in  figure  7.1.  Sections  7.1  and  8  describe  the  use  of  these  special  file  names.  The  number 
of  frame  buffers  available  depends  on  the  configuration  of  the  VICOM.  See  the  VICOM  Users' 
Manual  for  details  of  the  VICOM  frame  buffers  and  look-up-tables. 

Image  transfers  involve  moving  a  lot  of  data  aaoss  the  VAX  unibus,  and  should  be  con- 
sidered an  expensive  operation.  Further,  a  512  *-  '12  by  8  bit  image  occupies  a  quarter  mega- 
byte. Since  disk  storage  space  is  always  at  a  pronium,  users  should  never  store  entire  images  on 
disk  for  long  periods  of  time  (hours). 


7.1  Vsh  Commands  For  Image  Transfers 

This  section  describes  the  vsh  commands  and  macros  for  transferring  images  between  the 
VICOM  and  VAX  files. 


FiU  Name  Description 

/dev/vicoml  512  x  512  x  16  image  memory  1 

/dev/vicom2  512  x  512  x  16  image  memory  2 

/dev/vicom3  512  x  512  x  16  image  memory  3 


/dev/vicoml6  512  x  512  x  16  image  manory  16  (if  available) 

/dev/vicompp  4096  x  16  point  processor  look-up  table 

/dev/vicomr  1024  x  8  red  display  look-up  table 

/dev/vicomg  1024  x  8  green  display  look-up  table 

/dev/vicomb  1024  x  8  blue  display  look-up  table 


Figure  7.1.  VICOM  Related  ^)ecial  Files. 
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7.1.1  Load  and  Store.  The  most  cximmon  format  for  image  storage  is  one  pixel  per  8  bit  byte. 
The  easiest  way  to  transfer  images  in  this  formats  between  the  VICOM  image  memory  and  VAX 
files  is  with  the  load  and  store  commands.  The  store  command  is  used  to  store  a  VICOM  image 
memory  on  a  VAX  file,  and  load  is  used  to  move  a  VAX  image  file  onto  the  VICOM.  The 
forms  are: 

•>  load  A  filename 
•>  start  A  filename 

Here  A  is  the  image  file  number,  and  filename  is  the  VAX  file  name,  with  a  default  extension  of 
'.img'.  That  is,  if  no  extension  is  present  in  the  character  string  filename,  then  the  extension  '.img' 
is  appended  to  the  file  name  before  processing.  Thus  almost  all  VAX  image  files  will  have  the 
extension  '.img'.  It  is  also  assumed  that  the  VICOM  is  configured  for  512  by  512  images  (i.e.  the 
default  configuration  of  the  mem  command).  The  file  used  by  store  will  be  the  in  the  current 
working  directory,  if  a  complete  pathname  is  not  specified.  On  the  other  hand,  load  causes  vsh  to 
search  for  the  image  file  in  the  current  working  directory,  and  then  in  the  vsh  image  directory,  if  a 
full  path  is  not  specified.  The  location  of  the  vsh  image  directory  can  be  determined  from  the  vsh 
command  "•>  pvd". 

For  exaraplt, 

•>  load  1  oilcan 
•>  store  3  ../mom 

loads  the  512  by  512  image  1  from  the  file  oilcan.img,  and  stores  image  3  on  the  file  ../mom. img. 

Both  load  and  store  are  in  fact  maao  commands,  and  are  equivalent  to  the  commands 

•>  rim  i4  (filename,  2,  8196) 
•>  wimi4  (filename,  2,  8196) 

respectively,  as  described  in  the  next  section. 

7.1.2  Rim  and  WIm.  The  rim  command  is  used  to  read  an  image  from  a  VAX  file  to  the 
VICOM.  Conversely,  the  wim  command  is  used  to  write  an  image  from  the  VICOM  to  the 
VAX.  Note  that  the  commands  are  named  from  the  perspective  of  the  VICOM  (which  is  confus- 
ing, since  the  commands  are  submitted  to  vsh,  wliicfa  is  operating  on  the  VAX).  The  formats  are 

•>rimA  (filename,  mode,  blocksize) 
•>wim  A  (filename,  mode,  blocksize) 

where  A  is  the  image  number  (1,  2,  ...)  on  the  VICOM.  It  is  generally  assumed  that  the  VICOM 
is  in  the  512  by  512  image  mode  (i.e.,  a  default  mem  command  has  been  issued).  The  parameter 
filename  is  the  name  of  a  VAX  file,  with  a  default  extension  of  '.img'.  That  is,  if  no  extension  is 
present  in  filename,  then  the  extension  '.img'  is  appended.  The  mode  parameter  determines 
whether  or  not  the  VAX  file  is  packed.  Mode  =  1  means  that  the  data  is  transferred  16  bits  per 
fnxel,  whereas  mode  =  2  means  8  bits  per  pixel.  The  mode  parameter  may  be  omitted  if  the 
blochcize  parameter  is  also  omitted,  in  wliicfa  case  mode  =  2  is  assumed.  Blocksize  is  the  number 
of  pixels  per  block  for  the  transfer.  This  must  be  a  power  of  2  less  than  or  equal  to  8192.  Gen- 
erally, the  larger  the  blocksize,  the  faster  the  transfer.  Blocksize  =  8192  is  assumed  if  the  parame- 
ter is  omitted. 

The  syntax  described  for  wim  and  rim  is  as  defined  by  VICOM  Systems  Inc.  in  the  VICOM 
manual.  However,  the  parenthesis  and  comma  delimiters  can  be  replaced  with  spaces. 

For  the  rim  command,  if  filename  is  not  a  con^Iete  path  name,  then  vsh  searches  for  the 
VAX  file  first  in  the  user's  current  working  directory,  and  then  in  a  vjA-defined  directory  of 
images  available  for  general  use.  This  directory  is  called  the  vsh  image  directory.  You  can  print 
the  path  name  of  the  vsh  image  directory  by  issuing  the  vsh  command 
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•>  pvd 

(print  vsh  directories).  You  can  then  list  and  read  images  in  that  directory. 

The  wim  command  always  writes  (or  overwrites  an  existing  file)  in  the  current  working 
directory,  if  a  complete  pathname  is  not  specified. 

K  mode  =  1,  then  only  12  of  the  16  bits  per  pixel  transferred  by  the  wim  command  from  the 
VICOM  to  the  VAX  have  significance.  The  low  order  4  bits  will  be  undefined.  That  is,  the 
grqjhics  data  is  not  transferred  by  wIm.  In  order  to  transfer  16  bit  images  from  the  VICOM  to  a 
VAX  file,  you  should  first  issue  a  store,  foUowed  by  a  swa  (swap  bytes),  followed  by  another 
store  to  a  different  file,  and  another  swa  to  restore  the  image  data  back  to  the  original  format. 
On  the  other  hand,  mode  =  1  transfers  by  rim  from  VAX  files  to  the  VICOM  successfully 
transfer  16  bit  data,  and  load  gr^hics  data  if  the  gr^hics  nibble  is  not  write  protected. 

Examples  of  wim  and  rim  are: 

•>  wim  2  (oilcan) 

•>  rim  1  (envoy,  1,  4096) 

The  first  stores  image  2  in  a  file  'oilcan.img',  using  one  byte  per  pixel.  The  rim  command  loads 
image  1  from  a  file  called  'envoy.img*,  using  2  bytes  per  pixel,  and  transfer  in  blocks  of  4096  pix- 
els. 

The  rim  and  wim  commands  behave  a  bit  peculiarly  if  the  VICOM  is  not  in  the  standard  512 
by  512  image  mode  (i.e.,  if  a  mem  command  has  been  issued  with  nonstandard  image  size).  If 
the  images  do  not  have  512  columns  (i.e.,  '•>mem(r,  c)*  v/here  c  is  not  512)  the  result  of  a 
transfer  will  be  predictable  but  undoubtedly  not  what  is  desired.  If,  however,  the  images  have  512 
columns  but  not  512  rows,  the  appropriate  image  number  will  be  transferred  correctly,  and  a 
image  file  will  contain  something  other  than  a  qxiarter  million  pixels.  Thus  partial  VICOM  image 
memories  can  be  accessed  by  mem'ing  to  256  by  512,  128  by  512,  etc. 

7.1.3  Rdm  and  Wdm.  The  vsh  commands  rdm  and  wdm  are  used  to  transfer  partial  images  on 
the  VICOM,  using  one  block  for  the  transfer.  The  rdm  command  transfers  a  single  block  of  data 
in  a  VAX  file  to  the  start  of  a  designated  VICOM  image  manory.  The  wdm  command  transfers 
from  the  start  of  a  VICOM  image  memory  one  block  of  data  to  a  VAX  file.  Although  it  is  not 
possible  to  access  an  interior  portion  of  a  VICOM  image  manory  in  a  fixed  memory  configura- 
tion, as  with  rim  and  wim,  it  is  possible  to  mem  down  to  a  smaller  image  with  nonstandard 
number  of  rows  and  512  columns,  and  then  use  rdm  or  wdm  to  access  the  relevant  subimage. 

The  form  of  the  commands  is: 

•>  rdm  A  (filename,  mode,  blocksize) 
•>  wdm  A  (filename,  mode,  blocksize) 

The  parameters  are  the  same  as  in  rim  and  wim.  The  only  difference  is  that  rdm  and  wdm 
transfer  exactly  one  block,  whereas  rim  and  wim  transfer  a  sufficient  number  of  blocks  so  that  the 
entire  image  is  transferred. 


7.2  Image  I/O  Involving  Program  Variables 

User  programs  can  access  image  data  in  VAX  files  and  in  VICOM  image  memories.  The 
same  subroutines  are  used  to  access  both  VAX  files  and  VICOM  memories.  Image  data  can  be 
read  or  written,  using  subroutines  available  in  C,  Fortran,  or  Pascal.  The  routines  are  in  the  vsh 
library.  When  compiling  a  program  using  these  routines  use  the  '-Iv'  option  to  access  the  library. 
By  image  files,  we  mean  data  that  usually  rq^resents  image  intensity  or  feature  values,  organized 
by  rows  and  columns.  However,  image  files  can  also  be  used  to  store  histogram  vectors  and  table 
data  for  look-up-tables.  The  procedures  described  below  can  be  used  to  access  these  generalized 
image  files. 
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Image  I/O  using  these  routines  is  a  four  step  process.  Furst,  the  image  file  must  be  opened. 
VAX  files  are  named  with  an  absolute  or  relative  pathname;  VICOM  memories  are  named  by  the 
device  names  (see  Figure  7.1).  Next,  the  user  must  dedare  any  nonstandard  attributes  of  the 
image  file.  Attributes  determine  how  the  data  in  the  image  file  corresponds  to  image  values. 
Default  attributes  are  applied  if  none  are  declared.  Third,  data  is  read  or  written  using  the 
appropriate  procedure.  Different  procedures  are  provided  for  different  types  of  array  variables 
(floating  point,  integer,  etc.).  Fuially,  the  image  file  should  be  dosed. 

One  of  the  attributes  of  an  image  is  its  pixel  data  type:  images  can  be  fixed  point,  xmsigned 
integer,  signed  integer,  floating,  or  complex.  Reads  and  writes  also  have  types,  and  refer  to  the 
variable  type  of  the  array  containing  the  pixel  data.  If  the  types  match,  then  no  conversion  is 
needed  in  assigning  data.  If  the  types  differ,  then  an  implidt  conversion  takes  place  during  the 
read  or  write. 

7.2.1  Opening  an  Image.  To  open  an  image  for  reading  or  writing  from  C,  Fortran,  or  Pascal, 
use  the  function  procedure: 

imd  =  iopen(fUe,  rwmode) 

Here  file  is  a  character  string  or  constant  giving  the  VAX  file  or  VICOM  memory  to  be  opened, 
and  rwmode  is  0  for  read,  1  for  write,  and  2  for  read  and  write  access.  For  VAX  files,  file  is  sim- 
ply the  path  name  of  the  file;  for  VICOM  mranories,  file  is  of  the  form  Vdev/vicomx*,  where  x  = 
1,  2,  ...,  pp,  r,  g,  or  b.  The  returned  value  is  an  integer  value  which  will  be  used  to  designate  the 
image  file  in  the  remaining  image  I/O  procedures.  The  image  descriptor  imd  and  the  mode 
rwmode  variables  are  of  type  int,  Integer,  and  int  in  C,  Fortran,  and  Pascal  respectively. 

The  VICOM  point  processor  and  VICOM  display  tables  can  be  accessed  only  in  write  mode 
{rwmode  =  1).  Certain  protected  VAX  disk  image  files  can  only  be  opened  in  read  mode 
{rwmode  =  0). 

7.2.2  Declaring  Attributes.  The  attributes  that  an  image  file  can  have  are  listed  in  Figure  7.2. 
Not  all  attribute  values  are  legal  for  all  image  media.  VICOM  memories  have  a  restricted  range 
of  attribute  values.   Certain  attribute  values  restrict  the  range  of  other  attributes. 

The  type  attribute  determines  how  the  bit  string  values  in  each  pixel  are  translated  into  pixel 
values.  The  access  attribute  is  dther  sequential  or  direct;  sequential  access  implies  that  the  image 
will  be  accessed  left  to  right,  top  to  bottom,  successive  pixels,  starting  in  the  first  row,  first 
column.  Direct  access  image  files  can  be  read  in  any  order.  In  the  image  file,  each  pixel  can  liave 
1,  2,  3,  ...  or  up  to  64  bits  of  significance.  The  number  of  bits  used  to  store  this  information  is 
usually  the  same  as  the  number  of  bits  of  significance,  but  can  be  more.  These  two  parameters 
are  specified  by  the  attributes  nb  and  nstore  respectively.  The  hilo  attribute  specifies  whether  the 
nb  bits  come  from  the  high  or  low  part  of  the  nstore  storage  bits.  If  the  image  type  is  "fixed  point' 
then  hilo  defaults  to  the  high  order  portion  of  the  storage,  otherwise  hilo  defaults  to  the  low  order 
portion.  If  the  image  file  has  access  attribute  'direct',  then  it  is  possible  to  read  or  write  a  sub- 
sampled  subimage  of  the  image  file.  This  virtual  image  will  have  nrows  rows  and  ncols  (after  sub- 
sampling),  starting  in  the  fi-ow  row  and  fcol  column,  choosing  every  xsamp  pixel  along  each  row 
and  every  ysamp  pixel  along  each  column.  Here,  nrows,  ncols,  xsamp,  ysamp,  frow,  and  fcol  are 
positive  integer  valued  attributes.  When  writing  a  subimage,  the  remaining  pixels  will  rmiain 
either  unchanged  or  undefined.  If  ysamp  ^  1  or  fi'ow  ^  1  or  if  ncols»xsamp  is  not  the  full  width 
of  the  image  file,  then  the  width  of  the  actual  image  must  be  specified  in  the  width  attribute. 
When  reading  or  writing  a  subimage,  the  pixels  of  the  subimage  are  numbered  left  to  right,  top  to 
bottom,  within  the  subimage,  starting  with  pixel  number  1  at  location  [frcw,  fcot)  and  ending  with 
pixel  number  nrows*ncols  at  the  lower  right  comer  of  the  subimage. 

Attribute  values  are  generally  defaulted.  The  default  values  depend  on  whether  the  image 
file  is  a  VAX  disk,  VICOM  image  memory,  VICOM  point  processor  manory  table,  or  VICOM 
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Attribute 

Reference 
#                  Name 
(FORTEIAN)    (C&  Pascal) 

VAX 

file 

Allowed  Values 
VICOM    VICOM 
frame         pp 

VICOM 

display 

type 

1 

type 

1= fixed  point 
2= unsigned  int 
3= signed  int 
4= floating 
5= complex 

1 
2 
3 

1 

2 
3 

1 
2 

3 

access 

2 

access 

l=direct 
2= sequential 
(Tape  only 
sequential) 

1.2 

2 

2 

significant  bits 
storage  bits 

3 
4 

nb 
nstore 

1,2,...,64 
nb,...,(A 

8,12,16 
8,12,16 

16 
16 

8 
8 

high  or  low 
order  bits 

5 

hilo 

l=high 
2=low 

1,2 

1.2 

1,2 

number  of  rows 
number  of  columns 
x-sampling 
y-san^ling 
first  row 
first  column 
image  width 

6 

7 

8 

9 

10 

11 

12 

nrows 

ncols 

xsamp 

ysamp 

frow 

fcol 

width 

1,2,... 

1,2,... 
1,2,..., width 

1,2.... 
1,2,..., width 

1,2,... 

1,2,... 

1,..,512 
512 

1 

1 

1 

1 
512 

4 
512 
1 
1 
1 
1 
512 

1 

512 

1 

1 

1 

512 

Figure  7.2.  Image  Attributes. 


display  table.  Attribute  values  can  be  changed  at  any  time  the  image  file  is  open.  Attribute 
values  that  are  not  specifically  declared  will  retain  default  values,  based  on  the  image  type  and  the 
current  declared  and  defaulted  attribute  values.  The  procedure  for  dianging  attribute  values  is: 

i  =  iattr(u7u/.  iattrs) 

where  j  is  an  integer  returned  error  code  (see  Appendix  Q,  and  imd  the  image  descriptor  desig- 
nating the  image  file,  and  iattrs  is  a  pointer  to  the  structure  of  attribute  values.  In  C,  iattrs  is  a 
structure  which  is  declared  by  the  lines: 

#include  <iattr.h> 
struct  iattributes  'iattrs; 

Likewise  in  Pascal,  iattrs  is  a  pointer  to  a  record  structure  defined  by  the  lines: 

#indude  <iattrpas.h> 
var  iattrs:  iattrpointer; 

In  Fortran  77,  iattrs  is  an  integer  array  containing  20  values: 
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Integer  iattrs(20) 

The  elements  of  the  attribute  are  addressed  by  their  names  in  C  such  as  iattrs->type  and  iattrs- 
>access  and  in  Pascal  iattrs'.type  and  iattrs'. access.  In  Fortran,  the  elements  are  accessed  by 
number:  iattrsil)  for  the  type,  and  iattrs(2)  for  the  access  attribute  and  so  on.  Names  and 
numbers,  as  well  as  allowed  values  and  meanings  for  those  values  are  given  in  Figure  7.2. 

Attribute  values  are  declared  by  calling  iattr  with  the  appropriate  positive  integer  values  in 
attribute  elements  to  be  declared,  and  zero  values  m  attribute  elements  to  which  default  values  are 
to  be  applied.  A  call  to  iattr  with  zero  values  in  any  attribute  elements  will  cause  default  values  to 
be  applied  to  those  attributes,  regardless  of  the  previous  attribute  values.  Before  iattr  is  called, 
default  values  are  applied  to  all  attributes.    Thereafter,  attribute  values  many  be  changed  any 


Attribute 

VAX 

file 

VICOM 

frame 

VICOM 
PP 

VICOM 

display 

1.  type 

1 

1 

1 

1 

2.  access 

1 
(tape=2) 

1 

2 

2 

3.nb 

type= 
type= 
type= 
type- 
type= 

=  1 
=2 
=3 
=4 
=5 

12 
8 
8 

32 
64 

12 
12 
12 

16 
16 

16 
not  allowed 
not  aUowed 

8 
8 
8 

4.  nstore 

nb 

nb 

nb 

hb 

S.hilo 

1  if  type  =  : 

I,  otherwise  2 

6.  nrows 

512 

512 

7.  ncols 

512 

512 

512 

512 

8.  xsamp 

1 

1 

9.  ysamp 

1 

1 

\0.frow 

1 

1 

n.fcol 
12.  width 

1 

1 

ncols' 

*xsamD 

Figure  7.3.  Default  Attribute  Values. 
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number  of  times.  The  default  attribute  values  are  described  in  Figure  7.3. 

Attribute  values  for  an  image  are  not  stored  with  the  image.  It  is  the  responsibility  of  the 
user's  program  to  know  the  attributes  of  a  previously  created  image.  It  is  possible  to  declare  dif- 
ferent attributes  to  an  image  than  those  with  which  is  was  aeated.  Sometimes,  this  is  a  useful 
feature. 

7.2.3  Reading,  WrUng,  and  Seeking.    TTie  procedures  for  reading  and  writing  data  in  image  files 
have  the  form: 


ireadx 


ireadi 


ireads 


ireadf 


ireadb 


fixed 
point 

1 

unsigned 

integer 

2 

signed 

integer 

3 

x.2"*-i 
nb^32 

X 

nb^31 

X 

nAs32 

«isl6 

X 

X 

X 

nb=32 

float(x) 

f]oat(x) 

ireadz      complex(x,0.) 


ireadc  x 

nb=S 


complex(float(x)  ,0.) 


X 

ni=8 


true  if  x^O,  false  if  x=0 

X 

nb=S 


floating 

complex 

pomt 
4 

5 

int(x) 
nb=32 

int(modulus(x)) 
«6=64 

int(x) 
nb=32 

int(modulus(x)) 
nA=64 

X 

nb=32 

modulus(x) 
nb=M 

complex(x,0.) 
x=0 

X 

ni=64 

not 

not 

allowed 

allowed 

z  hi/low  order  nb  bits  of  image  file  datum  depending  on  the 

hilo  attribute.  Interpreted  according  to  the  type  of  the  image. 
intQ  convert  argument  to  an  integer. 

floatQ  convert  argument  to  a  32  bit  floating  point. 

complexQ  convert  arguments  to  a  64  bit  complex  number. 

modulusQ  modulus  of  the  complex  argument. 


Figure  7.4,  ireadx  Conversions. 
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num  =  ireadr(/>nJ,  iuf,  n) 
man  =  iwritx(iwui,  ii^,  n) 

where  x  =  i  (integer) 

s  (short  integer) 
f  (floating) 
z  (complex) 
b  (boolean) 
c  (diaracter). 

Thus  the  procedures  are  h%adl,  treads,  ireadf,  Ireadz,  ireadb,  and  ireadc  for  reading  and  Iwriti, 
iwrits,  Iwrhf,  twritz,  iwritb,  and  iwritc  for  writing.  For  x  =  i,  s,  f,  z,  b,  c,  the  array  birfis  of  type 
Integer  (32  bit  integer),  short  integer  (16  bit  integer),  floating  (i.e.,  real),  complex,  boolean,  or 
character  respectively.  When  reading,  data  is  transferred  from  the  image  file  to  the  array  variable 
btrf,  one  pixel  per  array  element,  subject  to  conversion  according  to  the  image  file  type  (as  declare 
in  the  image  file  attributes)  and  the  read  type,  as  indicated  by  x  =  i,  s,  f,  z,  b,  or  c.  The  manner 
of  the  conversion  is  described  in  Figure  7.4.  For  writing,  data  is  transferred  from  the  array  vari- 
able to  the  image  file,  one  element  per  pixel,  subject  to  the  conversion  as  described  in  Figure  7.5. 
Figure  7.4  gives  the  interpretation  of  the  value  loaded  into  an  element  of  bif,  given  the  nb  bits  of 
significance  from  the  image  file.  The  figure  also  gives  restrictions  on  nA  in  order  for  a  read  to  be 
legal.  In  Figure  7.5,  the  bits  of  the  elements  of  birf  ait  used,  and  are  translated  and  loaded  into 
nb  bits  of  the  nstore  bits  used  to  represent  the  pixel.  Generally,  the  remaining  bits  are  zero  filled. 
However,  when  writing  an  integer,  short  integer,  or  character  value  into  an  image  of  type  signed 
integer,  the  low  order  bits  are  loaded  with  the  2's  complement  value,  and  the  n2>*  bit  is  sign 
extended  to  the  left  to  fill  nstore  bits.  There  are  some  restrictions  on  nb  noted.  Further,  in  order 
for  the  results  to  be  meaningful,  the  values  of  the  bitf  array  should  lie  within  certain  ranges. 
These  ranges  are  noted. 

In  ireadz  and  rwritr,  the  transfer  of  the  n  pixek  of  data  begins  with  the  current  pixel,  and 
transfers  successive  pixels.  Pixels  are  numbered  left  to  right,  top  to  bottom,  in  the  virtual  (sub- 
sampled)  image  file  described  by  the  attributes.  The  current  pixel  is  1  wiien  the  image  is  opened, 
and  is  generally  one  greater  than  the  last  pixel  number  read  or  written.  The  current  pixel  number 
can  be  dianged,  however,  if  the  file  has  'direa'  access  attribute,  by  using  the  procedure  vseek. 
The  form  is: 

i  =  vseek(imd,  offset,  origin) 

where  imd  is  the  integer  image  descriptor  designating  the  image  file,  cffset  is  the  integer  pixel 
number  to  become  the  current  pixel  number,  measured  relative  to  the  location  specified  by  origin. 
If  the  integer  value  origin  =  0,  then  offset  is  the  pixel  number  relative  from  the  start  of  the  image. 
If  origin  =  1,  then  offset  measures  ahead  from  the  current  jrixel  location,  and  if  origin  =  2,  then 
offset  measures  back  from  the  last  pixel  in  the  image.  The  integer  i  is  an  error  code,  described  in 
Appendix  C. 

7.2.4  Qosiiig  an  Image  FDe.  Image  files  that  have  been  opened  by  lopen  are  dosed  by  normal 
termination  of  the  program,  or  explicitly  by  calling: 

/  =  idox(inul) 

w^ere  imd  is  the  integer  image  descriptor  and  j  is  an  integer  returned  error  code  (see  Appendix 
Q.  It  is  sometimes  necessary  to  dose  image  files  because  not  too  many  files  can  be  open  at  one 
time.  To  rewind  a  sequential  access  image  file,  it  suffices  to  dose  it  and  then  to  reopen  it.  Image 
files  that  are  dosed  by  idose  or  by  normal  termination  of  the  program  will  be  saved  by  the  file 
systwn. 
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iwritr 

fixed 
point 

1 

unsigned 

integer 

2 

signed 

integer 

3 

floating 

point 

4 

complex 

5 

iwriti  or 
iwrits 

fc/2"*-i 

_2nA-l<t<2'»*-l 

nis32 

b 

0si<2"* 

b 

-2'^"^:Si<2"*"^ 

nb^32 
(sign  extended) 

float(fc) 
nb=32 

complex(fc,0.) 
nb=M 

iwritf 

int(i*2"*-^) 

-1.0si<1.0 

nb^32 

not  allowed 

not  allowed 

b 

nb=32 

complex(i,0.) 
nb=64 

iwritz 

not  allowed 

not  allowed 

not  allowed 

not  allowed 

b 
nb=(A 

iwritb 

if  fctrue  1 
otherwise  0 

1 
0 

1 
0 

1. 
0. 

complex(l.,0.) 
coraplex(0.,0.) 

iwritc 

b 
nb^S 

b 
nb=S 

b 

nb=S 
(sign  extended) 

not  allowed 

not  allowed 

into 

floatO 

complexQ 


value  of  an  element  of  the  array  birf.  Interpreted 

as  specified  by  x  in  vwritx. 

convert  argument  to  an  integer. 

convert  argument  to  a  32  bit  floating  point. 

convert  arguments  to  a  64  bit  complex  number. 


NOTE:  Values  in  the  table  are  converted  to  the  type  specified  by  the  type  attribute,  and 
written  to  the  high  or  low  order  bits  of  the  nstore  storage  bits,  according  to  the  hilo  attri- 
bute. 


Figxire  7.5.  Data  values  written  by  iwritx. 


7.2 J  Exanqiies.  Some  examples  follow.  Sqjpose  we  open  an  image  file  for  reading,  with  attri- 
bute type  =  'fixed'.  Then  reading  using  treadf  will  produce  values  in  the  array  btrf  of  reals  in  the 
range  -1.  s  buf(i)  <  1.  An  integer  read  ireadi  will  produce  integer  birfvahies  in  the  range  - 
2fnb-:)  2  birf(i)  s  2^°*^^)  -1.  A  short  integer  read  ireads  will  produce  the  same  values  providing 
nb  s  15.  However,  if  the  image  is  declared  to  have  ^unsigned  integer*  type,  then  Ireadi  (and 
ireads,  providing  nb  ^  IS)  will  return  values  in  the  range  0  s  birf(i)  s  2"''-l. 

Suppose  we  open  a  disk  image  file  for  writing,  and  declare  it  to  be  of  type  'fixed',  with  nb  = 
4  (four  bits  of  significance  per  pixel).  To  save  storage  space,  we  allow  the  attribute  nstore  to 
default  to  nstore  =  4.   We  may  then  write  using  Iwritf,  loading  fci^  values  in  the  range  -1.  s 
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buf(i)  <  1.,  noting  that  since  there  are  only  4  bits  of  precision,  there  are  actually  only  16  quantiza- 
tion levels.  We  can  use  integer  bttf  values  in  the  range  -8,  ...,  7,  by  making  use  of  twriti,  or 
short  integer  buf  values  in  the  same  range  by  making  use  of  iwrits.  If  we  insist  on  thinking  of  the 
values  as  lying  in  the  range  0,  1,  ...,  15,  then  we  should  declare  the  image  to  have  type  attribute 
Hinsigned  integer',  and  then  load  birf values  in  the  range  0,  ...,  15  using  iwriti. 

The  above  example  gives  a  disk  file  with  4  bits  per  pixel,  and  cannot  be  loaded  onto  the 
VICOM  with  the  load  or  rim  vsh  commands.  Si^^XKC  we  wish  to  write  a  disk  file  which  can  later 
be  loaded.  Then  the  image  fDe  should  have  nb=S,  nstore=S,  ncols  =  nraws  =  512,  xsamp  = 
ysamp  =  fcol  =  Jtow  =  1,  and  be  of  type  fixed,  unsigned  integer,  or  signed  integer.  (Default  attri- 
butes suffice!)  If  the  type  is  fixed*,  (which  is  the  default),  then  data  can  be  written  using  Iwritf 
and  floating  btrf  values  in  the  range  [-1,  1),  or  by  using  iwriti  and  integer  fci^  values  in  the  range 
—  128,  -127,  ...,  127.  To  consider  the  data  in  the  range  0,  1,  ...,  255,  then  the  type  attribute 
should  be  declared  'imsigned  integer',  and  iwriti  or  iwrits  used  with  nonnegative  buf  values. 
Regardless  of  whether  the  image  was  written  sequentially  or  direct  access,  after  the  image  file  is 
dc»ed,  it  can  be  written  to  a  VICXDM  memory  by  the  load  vsh  command  (see  Section  7.1). 

The  rim  command  can  be  used  (with  mocU  =  1)  to  load  16  bit  data  onto  the  VICOM.  To 
write  a  disk  file  which  can  later  be  rim'ed  to  the  VICXDM  with  mode  =  1,  or  to  write  16  bits 
directly  to  the  VICOM,  open  the  image  file  with  attributes  nb  =  16,  nstore  =  16,  nrows,  ncols, 
xsamp,  ysamp,  fcol,  and  frow  defaulted,  and  type  either  fixed',  'xmsigned  integer',  or  'signed 
integer'.  Graphics  data  will  be  loaded  onto  the  VICOM  in  the  low  order  4  bits  of  the  16  bits 
traiuf erred.  With  unsigned  integer  type,  iwriti  should  be  used  with  fr:^  values  in  the  range  0,  1, 
...,  2^^-l  .  To  load  the  upper  12  bits,  leaving  the  graphics  nibble  unchanged,  the  data  VICOM 
memory  should  be  write  protected.  In  this  case,  it  is  often  more  convenient  to  write  the  image 
with  nb  =  12,  nstore  =  16,  and  type  =  fixed'  (with  hilo  =  'hi').  In  this  case  iwriti  takes  buf 
values  in  the  range  -2048,  ...,  2047,  and  loads  them  into  the  high  order  12  bits.  Keeping  the 
same  attributes,  but  setting  type  =  'unsigned  integer',  then  writi  takes  bitf  values  in  the  range  0, 
...,4095. 

A  disk  image  wliich  has  been  created  by  the  wim  vsh  command,  using  mode  =  1  transfer, 
contains  only  12  bits  of  precision  in  each  16  bit  pixel.  This  disk  file  can  be  read  by  opening  the 
image  file,  and  declaring  attributes  oi  nb  =  12,  nstore  =  16,  and  the  remaining  attributes 
defaulted.  Then  ireadf  yields  floating  birf  values  in  the  range  [-1,  1),  and  ireadl  will  yield  integer 
buf  values  in  the  range  -2048,  ...,  2047.  If  integer  values  in  the  range  0,  1,  ...,  4095  are  desired, 
then  the  image  can  be  declared  to  have  type  =  'unsigned  integer'  (instead  of  'fixed')  and  hilo  = 
'hi*,  and  then  read  using  ireadi  or  ireads.  Note  that  a  ireadf  in  the  latter  case  would  yield  floating 
^i^ values  in  the  range  0.,  1.,  ...,  4095. 

Of  course,  a  disk  image  file  created  by  a  wim  transfer  using  mode  =  2,  or  equivalently,  a 
store  command,  can  be  read  ""tiflg  default  attributes  and  ireadf  to  yield  values  in  the  range 
[-1,  1),  or  ireadi  or  ireads  to  yield  values  in  the  range  -128,  ...,  127.  To  obtain  values  in  the 
range  0,  ...,  255,  dedare  type  =  'unsigned  integer',  nb  =  S,  and  use  ireadi  or  ireads.  In  the  latter 
case,  ireadc  can  also  be  used  to  obtain  the  data  in  character  form,  \^ch  in  C  can  also  be  used  in 
arithmetic  expressions. 

Although  the  VICOM  memories  should  be  accessed  sequentially,  the  data  on  the  disk  may 
be  read  or  written  in  direct  access  mode  (i.e.,  vseek  may  be  used).  Moreover,  an  image  file  that 
has  16  bits  per  pixel,  or  any  other  size,  may  be  declared  with  nb  =  S,  and  type  fixed'  (say),  and 
then  read  using  ireadc  or  ireadi  to  obtain  raw  bit  data  about  each  byte  in  each  pixel.  In  this  case, 
sequential  read  traverses  the  image  low  order  bytes  to  high  order  bytes,  left  to  right,  top  to  bot- 
tom. 
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8  Look-Up-Tabies 

The  VICXDM  contains  foxir  look-up-tables.  The  point  processor  is  a  12  bit  in  -  16  bit  out 
look-up- table,  and  is  the  primary  table  for  performing  point  operations.  There  are  three  color 
display  look-up-tables  -  one  eadi  for  the  red,  green,  and  blue  display  channels.  These  tables  can 
be  used  for  point  operations,  but  are  generally  used  purely  for  pseudo  color  display.  The  display 
look-up-tables  are  10  bit  in  -  8  bit  out. 

Many  VICOM  commands  can  be  used  to  load  predefined  look-i^tables  into  the  point  pro- 
cessor. For  example,  exp,  log,  Un,  thr,  and  sli  are  commands  that  load  look-up-tables,  and  then 
perform  the  look-up  operation.  These  commands  can  also  load  the  same  tables  into  the  display 
look-up-tables.  See  the  section  of  Appendix  B  on  point  operations  for  a  complete  list. 

The  VICOM.  command  poi  can  be  used  to  perform  a  look-up  operation  if  the  correct  data  is 
already  loaded  into  the  point  processor  look-up-table. 

For  look-up-tables  that  cannot  be  constructed  from  any  of  the  predefined  VICOM  point 
operations,  mechanisms  are  provided  which  allow  the  user  to  load  user-defined  look-up-tables. 
Tliere  are  two  general  methods  for  accomplishing  this.  First,  one  can  write  a  program  which  uses 
one  of  the  subroutines  defined  in  Section  8.1  below,  such  that  \*^en  the  program  is  executed  a 
table  is  created  and  loaded  into  the  appropriate  VICOM  look-up-table.  The  second  possibility  is 
to  load  a  precompiled  table.  Precon^ed  tables  are  created  by  the  same  siJjroutines  but  the  table 
is  stored  in  a  disk  file  instead  of  being  loaded  directly  to  the  look-up-table.  This  precompiled 
table  can  then  be  loaded  into  the  appropriate  VICOM  look-up-table  with  vsh  commands  (described 
in  Section  8.2).  The  advantage  to  precooked  tables  is  that  they  can  be  reloaded  as  often  as 
desired  without  the  expense  of  recalc  ing  the  table  values.  The  first  option,  calculating  the 
table  on-line,  is  useful  if  the  table  is  to      used  very  rarely  or  v/hea  the  table  changes  dynamically. 

The  routines  described  below  are  intended  to  shield  the  user  from  the  mechanics  of  loading 
VICOM  look-up-tables.  However,  the  user  must  be  aware  that  loading  any  of  the  look-up-tables 
from  user  defined  tables  (as  opposed  to  built-in  VICOM  commands)  overwrites  the  first  4096  pix- 
els in  the  first  of  the  512  by  512  VICOM  images  (i.e.  the  first  8  rows  of  the  image).  Of  course,  if 
the  VICOM  is  mem'ed  to  non-standard  configuration  the  affected  pixels  may  spread  over  several 
images.' 

For  completeness,  the  data  representations  of  the  VICOM  look-up-tables  is  described  in  Sec- 
tion 8.3. 


8.1  Loading  Tables 

Two  routines  are  provided  for  loading  look-up-tables.  The  first,  wrlut,  requires  an  exter- 
nally defined  floating-point  function.  The  second,  wrluti,  uses  an  integer  array.  To  include  these 
routines  in  a  program  the  user  must  use  the  option  '-Iv'  on  the  compile  or  load  statement  for  the 
program  using  them  (see  Section  3.5). 

Wrba  has  the  following  form: 

WTlut(tablename,  fimc);  f or  C  or  Pascal 

call  vn\ut(tablename,  fimc)  for  FORTRAN 

where  tablename  is  a  character  string  and  fimc  is  an  externally  defined  function.  Tablename  tells 
wrlut  where  to  put  the  table  as  shown  in  Figure  8.1.  Func  must  be  a  floating-point  function  with  a 
single  floating-point  argument.  The  function  must  be  defined  on  the  interval 

-1  sx<  1, 

and  the  range  of  the  function  is  the  same  interval, 


The  reason  far  this  unfortunate  situation  is  that  the  PCS  VICC^  can  only  exchange  data  with  the  host  con^wter 
via  the  image  storage  areas. 
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-1  sfiinc(x)<  1 

Note  that  if  loaded  into  one  of  the  color  display  table,  func{x)  =  0  will  result  in  no  intensity 
for  that  color,  fimcix)  near  to  1  or  func{x)  near  -1  results  in  the  midrange  intensity  for  that  color, 
and  Junc(x)  =  -1/128  results  in  full  intensity. 

It  is  sometimes  useful  to  define  look-up-tables  in  terms  of  the  unsigned  integers  or  bit 
strings.  The  procedure  wrluti  allows  the  user  to  create  and  store  an  n-bit  in,  m-bit  out  look-up- 
table.  The  form  is 

wT\uti(table7U2me,  Uab,  n,  m);  f or  C  or  Pascal 

call  WT\uU{tabUname,  Uab,  n,  m)  FORTRAN 

Tablename  is  a  string  that  is  interpreted  just  as  for  wrlut.  Itab  is  an  array  (or  in  C  a  pointer  to  an 
array)  which  contains  2"  integer  values.  The  arguments  n  and  m  are  integers. 

The  arguments  n  and  m  are  the  number  of  input  and  output  bits  of  the  look-up-table,  respec- 
tively. The  restrictions  on  n  and  m  are,  1  s  n  s  12  and  1  s  m  s  16.  When  the  look-up-table  is 
applied,  the  high  order  n  bits  of  the  image  data  is  converted  into  an  index,  i,  into  the  array  itab, 
where  itablOJ  is  the  first  element  of  the  array.  The  low  order  m  bits  of  the  value  ixabli]  becomes 
the  high  order  m  bits  of  the  output.  Thus  there  must  be  2"  entrys  in  the  array  itab  and  each  entry 
should  satisfy 

0  s  itabli]  <  T"  where 

0s/s2"-l 

The  conversion  of  an  image  datum  into  an  index  is  straightforward.  For  the  point  processor, 
the  high  order  n  bits  are  converted  into  an  unsigned  integer  in  the  range  0  to  2"-l,  and  becomes 
the  index.  For  display  look-up-tables,  the  high  order  10  bits  of  the  pixel  value  is  padded  with  two 
low  order  1  bits,  and  then  the  high  order  n  bits  of  the  resulting  12  bit  value  is  made  into  the 
index. 

If  m  <  16,  then  all  unused  low  order  output  bits  will  be  manifest  as  0.  If  the  table  is  loaded 
into  a  display  look-up- table,  and  m  >  8,  then  only  the  high  order  8  bits  of  the  low  order  m  bits  of 
itabli]  are  used  in  the  output. 


tablename  =      /dev/vicompp  point  processor  look-up-table 

/dev/vicomr  red  display  look-up-table 

/dev/vicomg  green  display  look-i^table 

/dev/vicomb  blue  display  look-up-table 

filename  G[&  filename. ib\  if  no  extension  is  specified. 

Figure  8.1.  Look-up- table  names. 
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8.2  Loading  PrecompOed  Look-ap-tables 

If  wrlut  or  wrluti  has  been  used  to  create  a  table  on  a  disk  file,  then  that  table  can  be  loaded 
into  the  VICONTs  point  processor  with  the  following  vsh  command 

•>  Idpp  tablename 
Where  tablename  is  the  string  used  when  the  table  was  aeated.  A  more  general  vsh  command 

•>  Idlut  tablename  lut 

loads  the  display  look-up-tables  or  the  point  processor  look-up-table.  Tablename  is  as  before.  The 
lut  parameter  is  a  value  from  0  to  4  indicating  the  look-up-table  to  be  loaded,  according  to: 

lut  Lxx>k-up-table 

0  point  processor 

1  red  display 

2  green  display 

3  blue  display 

4  red,  green,  and  blue  displays 

Note  that  the  VICOM  command  poi  must  be  used  to  perform  the  look-up  operation  after 
the  point  processor  table  has  been  loaded. 

8.3  VICOM  Data  Stractures  for  Look-ap-taMes 

This  section  describes,  in  some  detail,  the  VICONTs  use  of  look-^>tables.   It  is  not  neces- 
sary to  read  this  section  to  use  the  VICONTs  look-up-tables. 

The  VICOM  command  Ink  is  used  to  transfer  data  from  the  first  4096  16-bit  values  in  the 
image  memory  into  the  point  processor  look-up-table,  or  one  of  the  display  look-up- tables.  Let  us 
interpret  those  4096  values  as  16-bit  unsigned  integers  m  the  range  0  to  Z^'*-!,  and  denote  the 
table  as  T[0],  T[l],  ...,  T[4095].  The  files  created  by  wrlut  and  wrluti  contain  4096  16-bit  values, 
and  are  identical  to  the  16-bit  image  data  T[0],  ...,  T[4095],  as  in  a  disk  image  file  (see  Section 
7.1). 

The  data  is  loaded  from  the  image  memory  into  the  point  processor  look-up-table  by  the 
VICOM  command 

•>  luk  (0)         or 
•>  luk 

The  look-up-table  operation  can  be  applied  by  the  VICOM  command  pol.  During  that  operation, 
the  high  order  12  bits  of  each  input  pixel  value  is  interpreted  as  an  unsigned  integer  in  the  range  0 
to  4095  to  yield  an  index  ».  The  output  of  the  look-up  operation  is  the  16  bit  T[/],  which  is  written 
in  the  output  pixel.  If  the  four  graphics  bits  of  the  output  pixel  is  write-protected,  then  only  the 
high  order  12  bits  of  T[(]  are  used. 

The  data  is  loaded  into  one  or  more  display  look-i^vtables  by  the  commands 

•>  luk  (1)  loads  the  look-up-table  for  the  red  display 

•>  luk  (2)  loads  the  look-up-table  for  the  green  display 

•>  luk  (3)  loads  the  look-i^vtable  for  the  blue  display 

•>  luk  (4)  loads  the  look-up-tables  for  the  all  three  (^splays 

For  display  tables,  1024  values  are  used,  namely,  T[3],  T[7],  T[ll],  ...,  T[4095].  The  display 
output  value  is  determined  from  the  high  order  10  bits  of  the  pixel  intensity  value.  These  10  bits 
are  padded  with  two  one  bits,  and  the  resulting  12-bit  value  is  interpreted  as  an  unsigned  integer 
in  the  range  0  to  4095  to  yield  an  index  i.  Tlie  output  display  look-up-table  will  be  the  high  order 
8  bits  of  the  16-bit  value  T[j]. 
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Appendix  A 

This  section  lists  the  VICXDM  cx)mmands  in  alphabetical  order.  The  syntax  for  each  com- 
mand is  followed  by  a  brief  description  foDowed  by  a  list  of  VICXDM  processors  involved  in  the 
command.  The  abbreviations  for  the  processors  are:  PP  for  the  point  processor,  M  for  the  micro 
processing  unit,  DC  for  the  display  controller,  VC  for  the  video  controDer,  and  AP  for  the  array 
processor.  For  descriptions  of  the  processors  see  "VICOM  User's  Guide". 

VICOM  Commands 


Command 

ADD  A3  >  C  (a) 

ADK  A  >  B  (a,  b) 

AND  A3  >  C 

ANK  A  >  B  (const) 

ARE  A  (xc,yc,plBne) 

ASH  A  >  B  (n) 

BAR  A 

BIT  (blt,dc) 

BOX  A  (xc,yc4i,w,val,back) 

CAM  A  (a,b) 

CDM  (count) 
CHE  A  (x,yAv) 

CHK  A  (xI,yl,x2,y2,const,n) 

COL  A3,C 

CON  A  (const) 

COP  A  >  B 

CUR  A  (x,y  .plane) 

DEF  (a) 

DEV  (a,b) 

DIG  A  (a) 

DIK  A  >  B  (const) 

DIL  A  >  B^,Y  (xl,yl,x2,y2) 

DEV  A,Z  (a) 

DISA 

DFV  A3  >  C 

DOT  A  (xl,yl,sh,$w4i,w,(k»t,b8ck) 

EDG  A  >  B,Z  (a) 

ELL  A  (xc,yc,m%{or,minor,ang4>plane) 

END 

ERF  A  >  B  (g,dc) 

EXP  A  >  B  (a,dc) 

EXTA 

FAL  A3,C  (a) 

FIL  A  (xcyc,plane) 

FU  A3  (n) 


Description 

a~l  scaled,  2  unsealed 

a-coost,  b-1  scaled,  2  unsealed 

logical  AND  of  images 

logical  AND  with  const 

area  within  closed  contour 

n«#  of  bits  to  die  right,  sign  extended 

bar  chan 

bit  slicing,  bit-l-8(msb  to  Isb) 

box  of  val  with  background  level  back 

a»l  interlace,  2  nor-interlace 

b"l  internal  control,  2  external 

continues  DMA 

checks  image  data  starting  at  (x,  y) 

vs.  the  n  values  in  v 

check  image  block  vs.  const  n  exceptions  listed 

display  color 

constant  image 

copy 

position  cursor  at  (x,  y) 

a"0  no  display  after  process,  l«display 

a«0  device  disaHe,  1  enable 

b-1  tablet,  2  joystick,  3  ball 

a"l  bottom  byte,  2  top  byte  digitization 

division  of  const'0.1  by  image 

expand  image  block  to  full  size 

frame  digit  and  tenp  intergratian 

a"number  of  frames  must  be  power  of  2 

display  A 

O.rA/B  (clipped  at  ±  1.) 

dot  chart 

a"  1  prewitt  sqrt,  2  prewin  mag, 

3  sobd  sqrt,  4  sdoA  mag 

ellipse  f"l  draw,  0  erase 

only  with  VERSADOS 

g-0  guassian  error  function,  1  inverse 

a"  1-4  expcanential 

print  max  and  min  pixel  values 

false  color  6  perms  of  RC® 

fill  closed  contour 

flicker  with  period  of  n  frames 


Processor 

FP 

PP 

FP 

PP 

M 

PP 

M 

DC 

MP? 

VCDC 

10 
M 

M 

DC 

EP 

PP 

M 

DC 

M 

VCDC 
PPAP 
MAPPP 
VDDCPP 

DC 
APPP 
MPP 
APPP 

M 
M 

PPDC 

PPDC 

M 

DC 

M 

DC 


vsh  Users'  Manual 


Appendix  A 


34 


Command 

GRA  A  >  B  (plane,dc) 

GRY  A  (a) 

HEQA>B(dc) 

mP  A  >  B,Z  (n.const) 

HIS  A  aow4iigb,plane) 

IMP  A  (x,y) 

INT(dc) 

EST  A  >  B  (dc) 

LEN  A  (xl,yl,plane,outlin£^,cs) 

LIN  A  >  B  (dlpl,dlph,ocUpl,odlph,dc) 

LMP((lc) 

LOG  A  >  B  (a.dc) 

LOO  (Ml) 

LOP  A  >  B,Z  (n,const) 

LSH  A  >  B  (n) 

LUK(dc) 

LUT(cfc) 

MAG  A  >  B  (dc) 

MAS  A  >  B  (a,v.b) 


MED  A  >  B  (vji) 

MEM  (rows.cols) 

MER  A3.C  >  D  (plane) 

MOM  A  (a) 

MOV  (filen,dwell,n,re€ls4oopiU 

MUK  A  >  B  (const) 

MULA3>  C 

.\EGA>B 

NOT  A  >  B 

0>fEA 

ORK  A  >  B  (const) 

ORR  A3  >  C 

OUT  A  >  B  (threshold) 

OVR  (color I,color2,color3,color4) 

PCR 

PER  A  (xc,yc,plaDe,outline4^,cs) 

PLO  A  (pa,pc,(lc,d) 


POIA>B 

POW  A  >  B  (a.dc) 

PRI  A  (xl,yl,c) 

PS£(a) 

PUT  A  (xl,yl4i,w.amp) 

QUI 


VICOM  Commands 

Description 

B(i,j)-TlA(i,j)] 
T  obtained  from  graphics  jia 
a- 1  honz,  2  ven,  3  diag 
histogram  equalization 
high  pass  filter  n-iterations  const-0-9 
histogram  plotted  in  gr^iiics 
maximum  in^xilse  at  x,y 
tables  for  integer  .node 
0.1/A  (dipped  at  i:l.) 
length  of  minimally  conneaed  line 
linear  point  transformation 
load  DC  from  origin  to  cursor 
log  function,  a- 1-4  (inv  to  EXP) 
loop  through  images  1-n,  display  each  t  frame  times 
low  pass  filter  n"  iterations  const  "0-9 
logical  shift  n  bits  right 

load  look-i^  from  image  memory  from  image  1 
load  loQk-1^3  from  microcoiEpurer  memory  (DOS) 
absolute  value 

a"0  user  defined  3x3  linear  mask  in  v 
1  North  2NE3E4SE5S6SW7W8NW 
9-11  Lapl  12-13  horz  14-15  ven  16-18  Icpass 
19-21  hipass  22  v.Une  23  h.line  24  0.5  diag 
plus  shaped  median  filter  v  by  h  (1,3^,7) 
configures  logical  memory 
merge  pair  under  controi  of  mask 
a-1  mean,  2  mean  variance  skewness 
movie  presentation  (DOS) 
multifiy  by  const 
C- A'B 
B-  -A 

logical  negation 
constant  image  FFFFH 
logical  OR  with  const 
logical  OR  of  images 
remove  outliers  in  a  neighborhood 
overlay  graphics  cciors  (1-8) 
prints  pixel  cursor  location  and  an^tude 
perimeter  of  closed  contour 
plot  lookup  table  in  graphics 
using  pa  for  axis  &  pc  for  curve  dc"0  PP 
c-2  DC  green  c-3  DC  blue  d-1  full  scale  d-2  -^ve 
B(i,j)"table[A(i,j)]  using  PP  table 
a"l  cube  root,  2  sqrt,  3  square,  4  cube 
prints  c  by  8  pixel  Wock  on  conscie 
pseudocolor 

writes  block  of  constant  value 
terminates  vicom  command  operations  (DOS) 


quad 


Processor 
FPDC 

M 

MPPDC 

PPAP 

M 

PP 

DC 

PPDC 

M 

PPDC 

M 

PPDC 

DC 

PPAP 

PP 

MPPDC 

MPPDC 

PPDC 

AP 


M 
M 

PP 
M 

DC  DISK  MP 
AP 

MPAP 
PP 
PP 
PP 
PP 
PP 
M 
DC 
M 
M 

MDC 
MDC 
1 

PP 

PPDC 
M 
DC 
M 
M 
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Command 

RAN  A  (a) 

RDM  A  (a^umber  llRjit  words) 

R£A  A  (filename^) 

REC  A  (xc,yc,h,w,ang^,plane) 

RED  A  >  B^.Y  (xl,yl^,y2) 

REP 

RES  (cam,pse,roani,scr,zoo) 

RIO  A  (a^umber  of  rows) 

ROA  (xc,yc) 

ROT  A  >  B^.Y  (xc,ycdegs) 

RUB  A  >  B  (dlpl,clipb,ocllpl,odlph^,y,(k) 

SAM  A  >  B  (xl,yl4i,w,vsany)4isamppt2,y2) 

SCA  A  >  B  (fract  diph^ract  dipl.dc) 

SCR  A  (dx.dy) 

SDM(a) 

SU  A  >  B  aow4il4h,bckgnid,dc) 

SPL  A3  >  C  (a) 

SUB  A3  >  C  (a) 

SUK  A  >  B  (const^) 

SVD  A  >  B,Y,Z  (a) 

SWA  A  >  B 

TEX  A  (xl,yl,ang4,e,plane,'text') 

TKR  A  >  B  (thresh,const,bckgnul,dc) 

TRA  (plane) 

TRH  A  >  B,Z  (vihift,hshlft) 

TRI  A3,C  >  D  (a,b,c) 

TRL  A  >  B  (vsliifUishlft,c) 

TRPA  >  B 

TWO  A>B 

UN'S  A  >  B,Z  (a,low  pass  impulse  response) 

VEC  A  (xl,yl^,y2,e,plane) 

WAI 

WAL  A  >  B,Z  (a,b,cd,e4) 

UDM  A  (a,number  16bit  words) 

WIO  A  (a^iumber  of  rows) 

WRI  A  (file^) 

WRP(a) 

XFR(file) 

XOK  A  >  B  (const) 

XOR  A3  >  C 

ZERA 

ZGR  A  (plane) 

ZOO  (a) 


VICOM  Commands 

Description 

random  image  a"  seed  must  be  odd 
read  image  block  a-1  16bit,  2  8bit 
read  frcxn  disk  a-1 16bit,  0  Sttt  (DOS) 

rectangle  f"l  dxaw,  0  erase 
reduction  into  Hock 
repeat  chain  file  sequence  (DOS) 
reset  to  default  (0  disable,  1  enable) 
read  image  a-1  16bit,  2  8bit 
image  roam 
rotation  about  (xc,  yc) 
rubber  band  x,y  inflection  pts. 
subsampling 
linearly  scale  image  to 
range  [0. 1] 

image  scroll  using  offset  (dx,  dy) 
suspend  active  DMA  a-0  status,  1  stop  DMA 
slicing,  bckgmd- 1  zero,  2  image 
sjiit  screen  a-1  lA,rB;  2  LA,1B;  3  rAjB 
a-1  scaled,  2  unsealed 
subtraa  const,  a-1  scaled,  2  unsealed 
convdution  a-file  of  3x3  kernels  (DOS) 
reverses  top  and  bottom  bytes 
write  text  f=0  small,  1  large  font 
threshold,  above  thresh  set  to  const 
rest  set  to  bckgmd 
trace  cursor 
image  translation 

tricciar  transform  D-aA-^bB+cC 
translation  c- unmapped  amp. 
transpose  image 
integer  to  two's  complement 
unsharp  mask  a-proportion 
line  e-1  draw,  0  erase 
delay  execution  for  0.5  sees  (DOS) 
wallis  stats,  mean,  std  dev,  nonnalization 
write  image  dock  a-1  16bit,  2  8bit 
write  image  a-1 16bit,  2  8bit  (DOS) 
write  to  disk  a-1  16bit,  2  8bit  (DOS) 
0  write  protect/enable  1  not  protected/disable 
2  write  protect/disable  3  not  proteaed/enaWe 
4096  words  transferred  to  micro  buffer  (DOS) 
xor  with  const 
exclusive  OR  of  images 
all  pixels  zero 
zero  graphic  memca7  plane -0  all 

zoom  by  faaor  1-6 


Processor 

M 

lO 

DiskC 

M 

APM 

M 

M 

lO 

DC 

APM 

PPDC 

M 

PPDC 

DC 

lO 

PPDC 

DC 

PP 

PP 

APPP 

PP 

M 

PPDC 

M 

PPAP 

AP 

MPP 

M 

PP 

PPAP 

M 

M 

APPP 

lO 

10 

DiskC 

M 

MIO 

PP 

FP 

PP 

PP 

DC 
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Appendix  B 

This  section  lists  the  VICOM  commands  grouped  by  operation  categories, 
abbreviations  are  the  same  as  for  Appendix  A. 

ALU  Operations 

Command  Description 


ADD  A3  >  C  (a) 
ADK  A  >  B  (a,  b) 
AND  A3  >  C 
AMK  A  >  B  (const) 
ASH  A  >  B  (n) 
DIK  A  >  B  (const) 
DIV  A3  >  C 
LSH  A  >  B  (n) 
MUK  A  >  B  (const) 
MULA3>  C 
NEGA>B 
NOT  A  >  B 
ORK  A  >  B  (const) 
ORR  A3  >  C 
SUB  A3  >  C  (a) 
SUK  A  >  B  (const^) 
XOK  A  >  B  (const) 
XOR  A3  >  C 


a-1  scaled,  2  unsealed 
a"  const,  b~l  scaled,  2  unsealed 
logical  AND  of  images 
logical  AND  widi  ?onst 
n-#  of  bits  to  the  right,  sign  extended 
division  of  const'0.1  by  image 
0.1'A^  (clipped  at  2:  1.) 
Ic^cal  shift  n  bits  right 
multiply  by  const 
C- A*B 
B--A 
logical  negation 
logical  OR  with  const 
logical  OR  of  images 
a"l  scaled,  2  unsealed 
subtiaa  const,  a-1  scaled,  2  unsealed 
xoT  with  const 
exclusive  OR  of  images 


The  processor 


Processor 

PP 

PP 

PP 

PP 

PP 

PPAP 

APPP 

PP 

AP 

MPAP 

PP 

PP 

PP 

PP 

PP 

PP 

PP 

PP 


Commarui 

COL  A3,C 

DISA 

FU  A3  (n) 

L00(t4i) 

MOV  (filen,dwell,n,reels4oopn) 

ROA  (xc,yc) 

SCR  A  (dx.dy) 

SPL  A3  >  C  (a) 

ZOO  (a) 


Display  Operations 

Description 

Processor 

disfiay  edar 

DC 

display  A 

DC 

flicker  with  period  of  n  frames 

DC 

loop  through  images  1-n,  display  each  t  frame  times 

DC 

movie  presentation  (DOS) 

DC  DISK  MP 

image  roam 

DC 

image  scroll  using  offset  (dx,  dy) 

DC 

split  scrrwi  a-1  1A,tB;  2  LA,1B;  3  rA,rB 

DC 

zoom  by  faaor  1-6 

DC 

Command 

EXTA 

HIS  A  (low4iigh,plane) 

MOM  A  (a) 


Analyze  Operations 

Description 

print  max  and  min  pixel  values 

histogram  plotted  in  graphics 

a"l  mean,  2  mean  variance  skewness 


Processor 

M 
M 
M 
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Command 

ARE  A  (xc,yc,pl«ne) 

m  A  (xc,ymi%) or, minor ,ang>f,plflne) 

FIL  A  (xc,yc,plaiie) 

LEN  A  (xl,yl,plane,oiitline4^,c$) 

OVR  (colorl,color2,CDlor3,color4) 

PER  A  (xc,yc,plane,outline^,cs) 

PLO  A  (pa,pc,dc,(l) 


REC  A  (xc,yc4i.w,ang4.plang) 
TEX  A  (xl,yl,angXe,plane,'text') 
VEC  A  (xl,ylpa,y2,e,plflne) 
ZGR  A  (plane) 


Graphics  Operations 

Description 

Processor 

area  within  closed  contour 

M 

ellipse  f- 1  draw,  0  erase 

M 

fiU  dosed  contour 

M 

length  of  minimally  conneaed  line 

M 

overlay  graphics  colors  (1-8) 

DC 

perimeter  of  dosed  contour 

M 

plot  lookup  table  in  gr^cs 

MDC 

using  pa  for  axis  &  pc  for  curve  dc"0  PP 

MDC 

c«2  DC  green  c-3  DC  blue  d-1  full  scale  d«2  +ve  quad 
rectangle  f"l  draw,  0  erase  m 

write  text  f-0  small,  1  large  font  M 

line  e"  1  draw,  0  erase  M 

zero  graphic  memory  i^ane"0  all  PP 


Command 

CDM  (cojmt) 

RDM  A  (a,mimber  16bit  words) 

RIO  A  (a,number  of  rows) 

SDM  (a) 

^\'DM  A  (a^umber  16bi     ords) 

^\10  A  (a4Uimber  of  rows; 

XFRCfile) 


I/O  Operations 

Description 

continues  DMA 

read  image  Wock  a"l  16bit,  2  8bit 

read  image  a- 1  16bit,  2  Sbit 

suspend  active  DMA  a"0  status,  1  stop  DMA 

write  image  block  a=l  16bit,  2  Sbit 

write  image  a-1 16bit,  2  Sbit  (DOS) 

4096  words  transferred  to  miao  buffer  (DOS) 


Processor 

lO 
10 
lO 
lO 
lO 
lO 
MIO 


Command 
EDG  A  >  B,Z  (a) 

MAS  A  >  B  (a,v,b) 


MED  A  >  B  (vji) 

OUT  A  >  B  (ttaresbold) 

UNS  A  >  B,Z  (ajow  pass  impulse  response) 

WAL  A  >  B,Z  (a,b,c,d,e^ 


Neighborhood  Operations 

Description 

a-1  prewitt  sqrt,  2  prewitt  mag, 

3  sobel  sqrt,  4  sobel  mag 

a-0  user  defined  3x3  linear  mask  in  v 

1  North  2NE3E4SE5S6SW7W8NW 

9-11  L^  12-13  horz  14-15  ven  16-18  lopass 

19-21  hipass  22  v.line  23  h.line  24  0.5  diag 

plus  shaped  median  filter  v  by  h  (1,3,5,7) 

remove  outliers  in  a  ndghborhood 

unsharp  mask  a-proporticD 

wallis  stats,  mean,  std  dev,  normalizatico 


Processor 
APPP 

AP 


M 

M 

PPAP 
APPP 
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Command 


CUR  A  (x,y .plane) 

DEV  (a,b) 

LMP((k) 

PCR 

TRA  (plane) 

Cursor  Operations 

Description 

Processor 

position  cursor  at  (x,  y) 

M 

a-0  device  disaHe,  1  enable 

M 

b"!  taWet,  2  joystick,  3  ball 

load  DC  from  origin  to  cursor 

M 

prints  pixel  cursor  location  and  amjiitude 

M 

trace  cursor 

M 

Command 

HIP  A  >  B,Z  (n,const) 
LOP  A  >  B,Z  (n,const) 
SVD  A  >  B,Y,Z  (a) 


Filter  Operations 

Description 

high  pass  filter  n"iterations  const"0-9 
lew  pass  filter  n"iteraticos  const"0-9 
ccnvdutior  affile  of  3x3  kernels  (DOS) 


Processor 

PPAP 
PPAP 
APPP 


Command 

BAR  A 

BOX  A  (xc,yc4i,w,val,back) 

CON  A  (const) 

DOT  A  (xl,yl,sh,sw4i,w,dot,back) 

GRY  A  (a) 

IMP  A  (x,y) 

ONE  A 

RAN  A  (a) 

ZERA 


Generate  Operations 

Description 

bar  chart 

boK  of  val  with  background  level  back 

constant  image 

doc  chart 

a-1  horiz.  2  ven,  3  diag 

maximum  impulse  at  x,y 

constant  image  FFITH 

random  image  a  ~  seed  must  be  odd 

all  pixels  zero 


Processor 

M 

MPP 

PP 

MPP 

M 

PP 

PP 

M 

FP 


Command 

DIL  A  >  B.X,Y  (xl,ylA2,y2) 
MER  A3.C  >  D  (plane) 
RED  A  >  B^.Y  (xl,ylA2,y2) 
ROT  A  >  B^,Y  (xcycdegs) 


Geometric  Operations 

Description 

expand  image  Uock  to  full  size 
merge  pair  under  control  of  mask 
reduction  into  block 
rotation  about  (xc,  yc) 


SAM  A  >  B  (xl,yl4i,w,vsamp4isaiiq>.x2,y2)  subsanpling 

TRH  A  >  B,Z  (vshlfl,hshlft)  image  translation 

TRL  A  >  B  (vshift,h<hlft,c)  translation  ^unmapped  anp. 

TRP  A  >  B  transpose  image 


Processor 

MAPPP 

PP 

APM 

APM 

M 

PPAP 

MPP 

M 
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Command 

FAL  A3.C  (a) 

PSE(a) 

TTU  A3,C  >  D  (a,b,c) 


Spectral  Operations 

Description 

false  color  6  perms  of  RCT 

pseudocdor 

tricolor  transform  D-aA+bB+cC 


Processor 

DC 
DC 
AP 


Command 
CAM  A  (a,b) 

DIG  A  (a) 
DIN  A,Z  (a) 


Video  Operations 

Description 

a~l  interlace,  2  non-interlace 

b~l  internal  control,  2  external 

a"  1  bottom  byte,  2  top  byte  digitizanon 

frame  digit  and  temp  intergration 

a"number  of  frames  must  be  power  of  2 


Processor 
VCDC 

VCDC 
VDDCPP 
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Point  Operations 


Command' 

BIT  (blt,dc) 
ERF  A  >  B  (g,<k) 
EXP  A  >  B  (a,dc) 
GRA  A  >  B  (plane,dc) 

HEQ  A  >  B  (dc) 

INT((k) 

EW  A  >  B  (dc) 

LIN  A  >  B  (dlpl,cliph,oclipl,odlph,dc) 

LOG  A  >  B  (a,dc) 

MAG  A  >  B  (dc) 

POIA>B 

POW  A  >  B  (a,dc) 

RL'B  A  >  B  (clipl,cliph,oclipl,ocliph^,y,dc) 

SCA  A  >  B  (frad  dlph^ract  dlpl.dc) 

SLI  A  >  B  Oow,high,bckgnid,dc) 
THR  A  >  B  (thresli,const,bckgnul,dc) 


Description 

Processor 

bit  slicing,  bit-l-8(msb  to  Isb) 

DC 

g-0  guassian  error  function,  1  inverse 

PPDC 

a"  1-4  exponential 

PPDC 

B(i,j)-IlA(i,j)] 

PPDC 

T  obtained  from  grapiiics  piot 

histogram  equalization 

MPPDC 

.tables  for  integer  mode 

DC 

0.1/A  (dipped  at  il.) 

PPDC 

linear  point  transfonnation 

PPDC 

log  function,  a- 1-4  (inv  to  EXP) 

PPDC 

absolute  value 

PPDC 

B(i,j)-table[A(i,j)]  in  PP  taWe 

PP 

a- 1  aihe  roa,  2  sqn,  3  square,  4  cube 

PPDC 

rubber  band  x,y  inflection  pts. 

PPDC 

linearly  scale  image  to 

PPDC 

range  [0, 1] 

slicing,  bckgmd-1  zero,  2  image 

PPDC 

threshold,  above  thresh  set  to  const 

PPDC 

rest  set  to  bckgmd 

Convnand 
CHE  A  (x,y^,v) 

CHK  A  (xl,yl,x2,y2,const^) 

COP  A  >  B 

DEF(a) 

END 

LUK(dc) 

LUT(dc) 

MEM  (rows,cols) 

PRI  A  (xl.yU) 

PUT  A  (xl,yl4i,w,amp) 

QUI 

REA  A  (fUenamca) 

REP 

RES  (cam,pse,roam,scr,zoo) 

SHA  A  >  B 

TWO  A>B 

WAI 

U-RI  A  (file,a) 


Utility  Operations 

Description  Processor 

checks  image  data  starting  at  (x,  y)  M 
vs.  the  n  values  in  v 

check  image  block  vs.  const  n  exceptions  listed  M 

copy  PP 

a"0  no  display  after  process,  1-display  DC 

only  with  VERSADGS  M 

load  look-up  from  image  memory  from  image  1  M  PP  DC 

load  look-up  from  microconputer  memory  (DOS)  M  PP  DC 

configures  logical  memory  M 

prints  c  by  8  pixel  block  on  console  M 

writes  out  Wock  M 

terminates  vicom  command  operations  (DOS)  M 

read  from  disk  a-1  16bit,  0  Bbit  (DOS)  DiskC 

repeat  chain  file  sequence  (DOS)  M 

reset  to  default  (0  disable,  1  enable)  M 

reverses  top  and  bottom  bytes  PP 

integer  to  two's  convenient  PP 

delay  execution  for  0.5  sees  (DOS)  M 

write  to  disk  a-1  16bit,  2  Bbit  (DOS)  DiskC 

0  write  protect/enaWe  1  not  proteaed/disaHe  M 
2  write  protect/disable  3  write  jrotect/enable 
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Appendix  C 

By  convention  any  vsh  function  that  returns  a  return  or  error  code  returns  zero  in  normal 
circumstances,  a  non-zero  returned  value  indicates  some  sort  of  exceptional  condition  (not  always 
serious).  Some  routines  return  codes  that  indicate  more  precisely  the  exceptional  condition,  the 
retumai  codes  are  listed  in  this  appendix.  The  first  list  contains  errors  from  within  vsh,  the  axles 
and  names  are  defined  in  the  header  file  vsh.h.  The  second  list  contains  error  returned  from  the 
VICOM,  many  of  the  errors  are  not  meaningful  for  our  system.  The  vsh  function  verrdesc,  given 
an  error  code,  returns  a  pointer  to  the  description  of  the  error.  The  following  code  fragment  per- 
forms a  vsh  command  and  then  prints  the  error  message  if  any. 


#indude  <vsh.h> 


mt  re, 

char  'command; 

re  =  vsh  (command); 
if  (re  1=  NO.XRROR) 

printf  ("  sh  error  -  %s  ,  verrdesc(rc)); 


Vsh  Related  Error  Codes 


Code 

Name 

Description 

0 

NO_ERROR 

No  error. 

1 

ABORT 

Chain  file  aborted. 

2 

NO.CHn  ,D 

No  child  process  in  vex,  disaster. 

3 

END_OF_Fn,F, 

EOF  or  end  encoxmtered. 

4 

CHAIN.OVERFLOW 

Too  many  chain  files. 

5 

NO.COUNT 

No  coimt  on  'do*  statranent. 

6 

CANT_DO 

Can't  do  this  command. 

7 

CANT_OPEN 

Can't  open  miage  file. 

8 

BADJO 

Disk  I/O  error  during  image  transfer. 

9 

DMA^DTSART,T=D 

Attained  transfer  while  DMA  disabled. 

10 

BADJ»ARAMErER 

Bad  parameter  on  vsh  command. 

11 

NO_FLAG 

No  sudi  flag. 

12 

EX.ERROR 

Error  in  shell  command. 

13 

GOT.TNTR 

Recrived  interrupt  signal. 

14 

WHATISTHIS 

What  was  that? 

15 

DMA^TOCKN) 

DMA  locked  by  some  other  processes. 

16 

NO_RFSPONSE 

No  response  from  VICOM  to  command. 
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VICOM  Error  Codes 


Code  Description 


64  Required  device  not  available. 

65  Command  is  ambiguous,  use  longer  form. 

66  Command  is  unknown,  try  another. 

67  An  operand  is  missing  from  the  command. 

68  An  invalid  image  number  is  specified. 

69  Command  format  is  incorrect. 

70  An  invalid  count  is  spedHed. 

71  An  invalid  numeric  constant  is  specified. 

72  An  invalid  file  name  is  given. 

73  Unable  to  assign  the  specified  file. 

74  I/O  error  occurred  while  transferring  image. 

75  Disk  error  occurred  while  closing  file. 

76  Unable  to  allocate  a  file  for  image. 

77  Error  in  loading  lookup  table. 

78  Device  is  currently  busy. 

79  Incompatible  images  have  been  specified. 

80  Graphics  commands  are  disabled. 

81  Cursor  not  active. 

82  Command  is  not  yet  implemented. 

83  Command  not  valid  for  this  memory  configuration. 

84  Device  write  protected. 

85  Error  detected  during  check. 

86  Warning  -  text  string  truncated. 

87  Outside  edge  of  contour  not  found. 

88  Unexpected  error  from  system  call. 

89  Device  still  active. 

90  Illegal  MOVIE  file  specified. 

91  Error  while  assigning  volume. 

92  Movie  loop  out  of  sync  with  display  controller. 
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Appendix  D 

This  is  a  list  of  the  known  problems  with  vsh  to  be  used  in  conjunction  with  the  "vsh  Users' 
Manual".  It  includes  bugs  as  well  as  unimplemented  features. 

(1)  The  pvd  command  is  not  implemented. 

(2)  The  VICOM's  frame  buffers  and  look-t^vtables  are  not  yet  available  as  special  files. 
They  can  be  accessed  by  the  routines  described  in  Section  7  of  the  vsh  manual. 

(3)  Parameters  can  not  contain  embedded  delimiters  as  described  m  Section  5.2.  At  present 
a  parameter  to  a  macro  file  must  be  a  word  surrounded  by  delimiters.  The  quotes,  both 
single  and  double,  are  treated  as  delimiters.  Also,  making  an  empty  parameter  between 
commas  etc.  does  not  work  as  desired. 

(4)  Default  parameter  values  as  described  m  Section  5.3  do  not  yet  exist.  An  undefined 
parameter  is  left  UNCHANGED. 

(5)  The  implanentation  of  interrupts  does  not  quite  match  the  description  in  section  5.9. 
When  invoked  by  the  sheD  command,  vsh,  *C  will  cause  a  chain  file  to  abort  an  return  to 
the  closest  level  receiving  input  from  a  terminal.  Pressing  *Z  will  normally  cause  the 
current  process  to  stop  returning  control  to  the  shell. 

(6)  The  ".tbl"  extension  described  in  Section  8.1  is  not  yet  implemented.  Look-up-tables 
have  the  same  extension  as  images,  ".img".  The  point  processor  table  can  be  loaded 
with  the  vsh  command,  table. 
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